Local Peer
localPeer object from huddleClient allows you to intereact with your own Peer object, which is how you are represented in the Huddle01 room.
Metadata
The updateMetadata method enables the Local Peer to update its metadata. You can add any custom metadata you want to the Local Peer.
// Update the metadata of the Local Peer
huddleClient.localPeer.updateMetadata({
displayName: "TEST",
avatarUrl: "AVATAR_URL"
});
// Get the metadata of the Local Peer
val metadata = huddleClient.localPeer.metadata;| Event Name | Description | Returns |
|---|---|---|
| metadata-updated | Triggered when metadata is updated | metadata: unknown |
updateRole
updateRole update the role of the Local Peer in the Room, this will emit an event updated with the updated role.
Parameters
| Params | Type | Description | Return Type |
|---|---|---|---|
| role | string | update the role of the Local Peer in the Room | void |
Example
// Usage
huddleClient.localPeer.updateRole({role:string});Events
| Event Name | Description | Returns |
|---|---|---|
| metadata-updated | Invoked when a local user metadata successfully updates. | { metadata: unknown } |
| permissions-updated | Invoked when a local user permissions successfully updates. | { permissions: TPermissions; role?: string } |
| role-updated | Invoked when a local user's role successfully updates. | { role: string } |
| stream-fetched | Invoked when a local peer stream is fetched. | { mediaKind: 'cam' | 'mic' | 'speaker', stream: MediaStream, label: string } |
| stream-closed | Invoked when a local peer stream is closed. | { label: string, mediaKind: 'cam' | 'mic' | 'speaker', reason?: { code: number, tag: string, message: string } } |
| stream-playable | Invoked when a local peer stream is playable. | { label: string, producer: Producer } |
| device-created | Invoked when a new device is created | { device: Device } |
| new-recv-transport | Invoked when a local peer is ready to consume stream | { transport: Transport } |
| new-send-transport | Invoked when a local peer is ready to produce stream | { transport: Transport } |
| receive-data | Invoked when a new data message is received from the other Remote Peers | { data: TDataMessage } |
| receive-volatile-data | Invoked when a new volatile data message is received from the other Remote Peers | { data: TDataMessage } |
| reconnected | Invoked when a local peer is reconnected. | { data: Socket } |
Example
// Event listeners for the Remote Peer
localPeer.on("metadata-updated", () => {
print("successfully updated remote peer metatdat.");
});
localPeer.once("stream-available", (data) => {
print("Remote Peer stream is avaialble.");
});
localPeer.off("stream-closed", () => {
print("Remote Peer Stream is closed.");
});