Overview

A Room Code is a unique encrypted short code generated by 100ms for a given Role and Room. A Room Code represents a unique role and room_id combination.

Why use Room Codes?

Essentially, Room Codes allow you to create unique Room Links and Room Code Authentication mechanism for every Role in a Room.

Room Links

Construct Prebuilt or custom domain Room Links; embed and share with your users

Room Links using Room Codes →

Room Code Authentication

Power Role specific authentication required to Join a Room

Join with Room Codes →

Room Codes Basics

  • Room codes are 10 digit short codes and follow a standard format - ***-****-***
  • Room codes require a Template, a Room and at least one Role to be created.

Room Code Lifecycle

A Room Code is a binary state entity represented by enabled: true | false. - enabled:true represents an enabled Room Code. Effectively, Room links and Room Code Authentication work with only enabled Room Codes. - enabled:false represents a disabled Room Code. Room links and Room Code Authentication does not work with disabled Room Codes.

You can get the state of a Room Code enable:true|false using Get Room Code API. Always make sure that this flag is enabled before creating Room Links or performing a peer join using Room Code Authentication.

You can manage the state of a Room Code for a Role and make it enabled/disabled using Update Room Code API

Room Codes do not expire

Room Codes do not have an expiry, thus, you can reuse Room Codes infinitely. This enables “fixed Room Links” that can be reused / re-shared or allocated to your end users. No need to generate new Room Links for every Session for a given room_id. However, if your use case requires "fresh Room Links" and discard old links, you should first disable the intended Room Codes and then generate new Room Codes for a role using Create Room Code API or Create Role Room Code API.

Creating Room Codes

For Rooms created on 100ms dashboard, a room code gets generated for every role in the room by default.

JoinRoomModal

Multiple Room Codes per role

100ms also supports multiple Room Codes per Role (up to 100 Room Codes per Room). This means that each user for a given role can be associated with a unique Room Code, and thus allow you to created unique room links for each user and unique Room Code based authentication. Please handle the logic to map Room Codes on user level at your end as we support Room Code creation only on Role and not Peer level.


Have a suggestion? Recommend changes ->

Was this helpful?

1234