@100mslive/server-sdk v0.3.0

100ms NodeJs Server Side SDK

Note

This is beta, APIs might change

Documentation

The examples/nodejs folder on root has some examples.

Docs

Env Variables to configure(optional)

• HMS_ACCESS_KEY => access key as present in dashboard's developer section
• HMS_SECRET => app secret as present in dashboard's developer section

Create SDK Instance

const sdk = new HMSSDK(accessKey, secret);

Generating management token

console.log(await sdk.getManagementToken());
// with token options -
console.log(await sdk.getManagementToken({ issuedAt, notValidBefore, validForSeconds }));

Generating Auth token

console.log(await sdk.getAuthToken({ roomId, role, userId }));
// with token options -
console.log(
  await sdk.getAuthToken({ roomId, role, userId, issuedAt, notValidBefore, validForSeconds })
);

Creating and Updating Room

const roomService = sdk.getRoomService();
const room = await roomService.createRoom();
// with room options -
const roomWithOptions = await roomService.createRoom({ name, description, recording_info, region });

const updatedRoom = await roomService.updateRoom(room.id, { name });
console.log(room, roomWithOptions, updatedRoom);

List Peers in an Active Room and send a Message

const activeRoomService = sdk.getActiveRoomService();
const peers = await getActivePeers(roomId);
console.log(peers);

await sendMessage(roomId, { message: "test" });

Get all Sessions

const sessionService = sdk.getSessionService();
const allSessionsIterable = await getAllSessionsIterable();

const allSessions = [];
while (true) {
  const someSessions = await allSessionsIterable.next();
  if (someSessions.length == 0) break;
  sessions.push(...someSessions);
}
console.log(allSessions);

Errors

Errors will follow the below interface, code is HTTP Status Code.

interface HMSException {
  code?: number;
  name: string;
  message: string;
}

e.g.

const hlsErr = {
  code: 404,
  name: "Not Found",
  message: "hls not running",
};