Class RtmClient

Class that represents the RTM client. You can call the createInstance method of AgoraRTM to create an RtmClient instance. This class is the entry point of the Agora RTM SDK.

No Inherit Doc

Hierarchy

EventEmitter<RtmClientEvents>
- RtmClient

Constructors

constructor

new RtmClient(): RtmClient
Returns RtmClient

Inherited from EventEmitter<RtmEvents.RtmClientEvents>.constructor

Properties

`Static` defaultMaxListeners

defaultMaxListeners: number

Methods

addOrUpdateChannelAttributes

addOrUpdateChannelAttributes(channelId: string, attributes: AttributesMap, options?: ChannelAttributeOptions): Promise<void>
Adds or updates the attributes of a specified channel.

This method updates the specified channel's attributes if it finds that the attributes has/have the same keys, or adds attributes to the channel if it does not.

Note
- You do not have to join the specified channel to update its attributes.
- The attributes of a channel will be cleared if the channel remains empty (has no members) for a couple of minutes.
- For setLocalUserAttributes, addOrUpdateChannelAttributes, deleteChannelAttributesByKeys, and clearChannelAttributes taken together: the call frequency limit is 10 calls every five seconds.
Parameters
- channelId: string
  
  The channel ID of the specified channel.
- attributes: AttributesMap
  
  An array of channel attributes.
- Optional options: ChannelAttributeOptions
  
  Options for this attribute operation. See ChannelAttributeOptions.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1818

addOrUpdateLocalUserAttributes

addOrUpdateLocalUserAttributes(attributes: AttributesMap): Promise<void>
Adds or updates the local user's attributes.

This method updates the local user's attributes if it finds that the attributes has/have the same keys, or adds attributes to the local user if it does not.
Returns
The Promise resolves after successfully adding or updating the local user's attributes.
Parameters
- attributes: AttributesMap
  
  The attributes to be added or updated.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1547

clearChannelAttributes

clearChannelAttributes(channelId: string, options?: ChannelAttributeOptions): Promise<void>
Clears all attributes of a specified channel.

Note
- You do not have to join the specified channel to clear its attributes.
- For setChannelAttributes, addOrUpdateChannelAttributes, deleteChannelAttributesByKeys, and clearChannelAttributes taken together: the call frequency limit is 10 calls every five seconds.
Parameters
- channelId: string
  
  The channel ID of the specified channel.
- Optional options: ChannelAttributeOptions
  
  Options for this attribute operation. See ChannelAttributeOptions.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1750

clearLocalUserAttributes

clearLocalUserAttributes(): Promise<void>
Clears all attributes of the local user.

Returns
The Promise resolves after successfully clearing the local user's attributes.

Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1571

createChannel

createChannel(channelId: string): RtmChannel
Creates an RtmChannel instance.

Returns
An RtmChannel instance.
Parameters
- channelId: string
  The unique channel name of the Agora RTM channel. The string length must be less than 64 bytes with the following character scope:
  - All lowercase English letters: a to z
  - All uppercase English letters: A to Z
  - All numeric characters: 0 to 9
  - The space character.
  - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ","
  Note:
  - The channelId cannot be empty, null, or "null".
Returns RtmChannel
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1502

createLocalInvitation

createLocalInvitation(calleeId: string): LocalInvitation
Creates a LocalInvitation instance.

Returns
A LocalInvitation instance.
Parameters
- calleeId: string
  
  The uid of the callee.
Returns LocalInvitation
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1513

createMediaMessageByUploading

createMediaMessageByUploading(payload: Blob, params?: {
    description?: string;
    fileName?: string;
    messageType?: "FILE";
    thumbnail?: Blob;
}, transHandler?: MediaTransferHandler): Promise<RtmFileMessage>
Uploads a file to the Agora server to get an RtmFileMessage instance for file messages.

Example
```
// Blob from a file
const blob = <Blob>
// Upload a file to create an RtmFileMessage instance
const mediaMessage = await client.createMediaMessageByUploading(blob, { messageType: 'FILE' })
// Send a peer-to-peer file message
await client.sendMessageToPeer(mediaMessage, <peerId>)
```
Returns
The Promise resolves after the file is successfully uploaded. The value of the Promise is an RtmFileMessage instance for sending channel messages and peer-to-peer messages.
Parameters
- payload: Blob
  
  Content of the file in binary format. Must not exceed 32 MB in size.
- Optional params: {
      description?: string;
      fileName?: string;
      messageType?: "FILE";
      thumbnail?: Blob;
  }
  Contains the name of the file to upload, the description of the file message, the thumbnail, and the message type.
  - fileName string
    Name of the file to upload. The maximum total size of fileName, description, and thumbnail is 32 KB.
  - description string
    Description of the file message. The maximum total size of fileName, description, and thumbnail is 32 KB.
  - thumbnail undefined | Blob
    Thumbnail of the file to upload. Must in binary format. The maximum total size of fileName, description, and thumbnail is 32 KB.
  - messageType ''FILE''
    Message type. ''FILE'' stands for file messages.
  - Optional description?: string
  - Optional fileName?: string
  - Optional messageType?: "FILE"
  - Optional thumbnail?: Blob
- Optional transHandler: MediaTransferHandler
  
  A MediaTransferHandler instance. You can use this parameter to cancel an upload or report the upload progress.
Returns Promise<RtmFileMessage>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1968
createMediaMessageByUploading(payload: Blob, params?: {
    description?: string;
    fileName?: string;
    height?: number;
    messageType?: "IMAGE";
    thumbnail?: Blob;
    thumbnailHeight?: number;
    thumbnailWidth?: number;
    width?: number;
}, transHandler?: MediaTransferHandler): Promise<RtmImageMessage>
Uploads an image to the Agora server to get an RtmImageMessage instance for sending image messages.

Example
```
// Blob from an image
const blob = <Blob>
// Upload an image to create an RtmImageMessage instance
const mediaMessage = await client.createMediaMessageByUploading(blob, {
messageType: 'IMAGE',
fileName: 'file_name',
description: 'description',
thumbnail: blob,
width: 100,
height: 200,
thumbnailWidth: 50,
thumbnailHeight: 200,
})
// Send a peer-to-peer image message
await client.sendMessageToPeer(mediaMessage, <peerId>)
```
Returns
The Promise resolves after the image file is successfully uploaded. The value of the Promise is an RtmImageMessage instance for sending channel messages and peer-to-peer messages.
Parameters
- payload: Blob
  
  Content of the image in binary format. Must not exceed 32 MB in size.
- Optional params: {
      description?: string;
      fileName?: string;
      height?: number;
      messageType?: "IMAGE";
      thumbnail?: Blob;
      thumbnailHeight?: number;
      thumbnailWidth?: number;
      width?: number;
  }
  Contains the the width, height, name of the image file to upload, the description of the image message, the thumbnail, the width and height of the thumbnail, and the message type.
  - width number
    Width of the image file to upload in pixels. If you do not specify this value and the uploaded file format is JPG, JPEG, BMP, or PNG, the SDK automatically calculates the width. The SDK does not resize or crop the image.
  - height number
    Height of the image file to upload in pixels. If you do not specify this value and the uploaded file format is JPG, JPEG, BMP, or PNG, the SDK automatically calculates the height. The SDK does not resize or crop the image.
  - fileName string
    Name of the image file to upload. The maximum total size of fileName, description, and thumbnail is 32 KB.
  - description string
    Description of the image message. The maximum total size of fileName, description, and thumbnail is 32 KB.
  - thumbnail undefined | Blob
    Thumbnail of the image to upload. Must in binary format. The maximum total size of fileName, description, and thumbnail is 32 KB.
  - thumbnailWidth undefined | number
    Width of the thumbnail in pixels. If you do not specify this value, the SDK automatically calculates the width.
  - thumbnailHeight undefined | number
    Height of the thumbnail in pixels. If you do not specify this value, the SDK automatically calculates the height.
  - messageType ''IMAGE''
    Message type. ''IMAGE'' stands for image messages.
  - Optional description?: string
  - Optional fileName?: string
  - Optional height?: number
  - Optional messageType?: "IMAGE"
  - Optional thumbnail?: Blob
  - Optional thumbnailHeight?: number
  - Optional thumbnailWidth?: number
  - Optional width?: number
- Optional transHandler: MediaTransferHandler
  
  A MediaTransferHandler instance. You can use this parameter to cancel an upload or report the upload progress.
Returns Promise<RtmImageMessage>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:2058

createMessage

createMessage<T>(message: Partial<T>): T
Creates a message instance for sending peer-to-peer or channel messages. For file messages and image messages, if the corresponding files or image files have been uploaded and the media IDs are still valid, you can call this method to get a message instance for sending peer-to-peer or channel messages.

Example
```
const mediaMessage = client.createMessage({
mediaId: <mediaId>,
mediaType: 'FILE',
}) // Create an RtmFileMessage instance
```
Returns
A message instance to send. You can use the message instance to send peer-to-peer or channel messages.
Type Parameters
- T extends RtmMessage
  
  A RtmMessage type.
Parameters
- message: Partial<T>
  
  An object that includes any property of RtmMessage.
Returns T
- Defined in node_modules/agora-rtm-sdk/index.d.ts:2151

deleteChannelAttributesByKeys

deleteChannelAttributesByKeys(channelId: string, attributeKeys: string[], options?: ChannelAttributeOptions): Promise<void>
Deletes the local user's attributes using attribute keys.

Note
- You do not have to join the specified channel to delete its attributes.
- The attributes of a channel will be cleared if the channel remains empty (has no members) for a couple of minutes.
- For setLocalUserAttributes, addOrUpdateChannelAttributes, deleteChannelAttributesByKeys, and clearChannelAttributes taken together: the call frequency limit is 10 calls every five seconds.
Parameters
- channelId: string
  
  The channel ID of the specified channel.
- attributeKeys: string[]
  
  A list of channel attribute keys.
- Optional options: ChannelAttributeOptions
  
  Options for this attribute operation. See ChannelAttributeOptions.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1781

deleteLocalUserAttributesByKeys

deleteLocalUserAttributesByKeys(attributeKeys: string[]): Promise<void>
Deletes the local user's attributes using attribute keys.

Returns
The Promise resolves after successfully deleting the local user's attributes.
Parameters
- attributeKeys: string[]
  
  A list of the attribute keys to be deleted.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1561

downloadMedia

downloadMedia(mediaId: string, transHandler?: MediaTransferHandler): Promise<Blob>
Downloads a file or image file from the Agora server by media ID.

Example
```
// Download a file blob
client.on('MessageFromPeer', async message => {
if (message.messageType === 'FILE') {
const blob = await client.downloadMedia(message.mediaId)
}
})
```
Returns
The Promise is resolved when the download is complete. The value of the Promise is the Blob instance that represents the downloaded file or image file.
Parameters
- mediaId: string
  
  Media ID of the uploaded file or image file. The SDK automatically returns a media ID when a file or image file is successfully uploaded to the Agora server. You can use the RtmFileMessage instance or the RtmImageMessage instance to get the media ID of a file or image file.
- Optional transHandler: MediaTransferHandler
  
  A MediaTransferHandler instance. You can use this parameter to cancel a download or report the download progress.
Returns Promise<Blob>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:2109

getChannelAttributes

getChannelAttributes(channelId: string): Promise<ChannelAttributes>
Gets all attributes of a specified channel.

Note
- You do not have to join the specified channel to delete its attributes.
- For getChannelAttributes and getChannelAttributesByKeys taken together: the call frequency limit is 10 calls every five seconds.
Parameters
- channelId: string
  
  The ID of the specified channel.
Returns Promise<ChannelAttributes>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1700

getChannelAttributesByKeys

getChannelAttributesByKeys(channelId: string, keys: string[]): Promise<ChannelAttributes>
Gets the attributes of a specified channel by attribute keys.

Note
- You do not have to join the specified channel to get its attributes.
- For getChannelAttributes and getChannelAttributesByKeys taken together: the call frequency limit is 10 calls every five seconds.
Parameters
- channelId: string
  
  The ID of the specified channel.
- keys: string[]
  
  An array of attribute keys.
Returns Promise<ChannelAttributes>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1724

getChannelMemberCount

getChannelMemberCount(channelIds: string[]): Promise<ChannelMemberCountResult>
Gets the member count of specified channels.

Note
- The call frequency limit for this method is one call per second.
- We do not support getting the member counts of more than 32 channels in one method call.
Parameters
- channelIds: string[]
  
  An array of the specified channel IDs.
Returns Promise<ChannelMemberCountResult>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1676

getUserAttributes

getUserAttributes(userId: string): Promise<AttributesMap>
Gets all attributes of a specified user.
Parameters
- userId: string
  
  The user ID of the specified user.
Returns Promise<AttributesMap>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1583

getUserAttributesByKeys

getUserAttributesByKeys(userId: string, attributeKeys: string[]): Promise<AttributesMap>
Gets the attributes of a specified user by attribute keys.
Parameters
- userId: string
  
  The user ID of the specified user.
- attributeKeys: string[]
  
  An array of the attribute keys.
Returns Promise<AttributesMap>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1597

listenerCount

listenerCount<P, T>(this: T, event: P): number
Type Parameters
- P extends keyof RtmClientEvents
- T
Parameters
- this: T
- event: P
Returns number
Inherited from EventEmitter.listenerCount
- Defined in node_modules/agora-rtm-sdk/index.d.ts:200

listeners

listeners<P, T>(this: T, event: P): Function[]
Type Parameters
- P extends keyof RtmClientEvents
- T
Parameters
- this: T
- event: P
Returns Function[]
Inherited from EventEmitter.listeners
- Defined in node_modules/agora-rtm-sdk/index.d.ts:198

login

login(options: {
token?: string;
uid: string;
}): Promise<void>
Logs in to the Agora RTM system.

Note
If you use the Agora RTM SDK together with the Agora RTC SDK, Agora recommends that you avoid logging in to the RTM system and joining the RTC channel at the same time.

Note
If the user logs in with the same uid from a different instance, the user will be kicked out of your previous login and removed from previously joined channels.

Returns
The Promise resolves after the user logs in to the Agora RTM system successfully.
Parameters
- options: {
  token?: string;
  uid: string;
  }
  - Optional token?: string
    
    An optional token generated by the app server.
  - uid: string
    The uid of the user logging in the Agora RTM system. The string length must be less than 64 bytes with the following character scope:
    
    All lowercase English letters: a to z
    
    All uppercase English letters: A to Z
    
    All numeric characters: 0 to 9
    
    The space character.
    
    Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ","
    
    Note
    
    The uid cannot be empty, or set as null or "null".
    
    We do not support uids of the number type and recommend using the toString() method to convert your non-string uid.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1406

logout

logout(): Promise<void>
Allows a user to log out of the Agora RTM system.

After the user logs out of the Agora RTM system, the SDK disconnects from the Agora RTM system and destroys the corresponding event listener.

Returns
The Promises resolves after the user logs out of the Agora RTM system and disconnects from WebSocket.

Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1418

off

off<P, T>(this: T, event: P, listener: ((...args: any[]) => any)): RtmClient
Type Parameters
- P extends keyof RtmClientEvents
- T
Parameters
- this: T
- event: P
- listener: ((...args: any[]) => any)
  - - (...args: any[]): any
    - Parameters
      
      Rest ...args: any[]
      
      Returns any
Returns RtmClient
Inherited from EventEmitter.off
- Defined in node_modules/agora-rtm-sdk/index.d.ts:191

on

on<EventName>(eventName: EventName, listener: ((...args: ListenerType<RtmClientEvents[EventName]>) => any)): RtmClient
Adds the listener function to the channel for the event named eventName. See the EventEmitter API documentation for other event methods on the RtmClient instance.
Type Parameters
- EventName extends keyof RtmClientEvents
Parameters
- eventName: EventName
  
  The name of the RTM client event. See the property names in the RtmClientEvents for the list of events.
- listener: ((...args: ListenerType<RtmClientEvents[EventName]>) => any)
  
  The callback function of the RTM client event.
  - - (...args: ListenerType<RtmClientEvents[EventName]>): any
    - Parameters
      
      Rest ...args: ListenerType<RtmClientEvents[EventName]>
      
      Returns any
Returns RtmClient
Overrides EventEmitter.on
- Defined in node_modules/agora-rtm-sdk/index.d.ts:2163

once

once<P, T>(this: T, event: P, listener: ((...args: ListenerType<RtmClientEvents[P]>) => void)): RtmClient
Type Parameters
- P extends keyof RtmClientEvents
- T
Parameters
- this: T
- event: P
- listener: ((...args: ListenerType<RtmClientEvents[P]>) => void)
  - - (...args: ListenerType<RtmClientEvents[P]>): void
    - Parameters
      
      Rest ...args: ListenerType<RtmClientEvents[P]>
      
      Returns void
Returns RtmClient
Inherited from EventEmitter.once
- Defined in node_modules/agora-rtm-sdk/index.d.ts:185

queryPeersBySubscriptionOption

queryPeersBySubscriptionOption(option: ONLINE_STATUS): Promise<string[]>
Gets a list of the peers, to whose specific status you have subscribed.
Parameters
- option: ONLINE_STATUS
  
  The status type, to which you have subscribed. See RtmStatusCode.PeerSubscriptionOption.
Returns Promise<string[]>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1908

queryPeersOnlineStatus

queryPeersOnlineStatus(peerIds: string[]): Promise<PeersOnlineStatusResult>
Queries the online status of the specified users.
Parameters
- peerIds: string[]
  
  A list of the user IDs. The number of user IDs must not exceed 256.
Returns Promise<PeersOnlineStatusResult>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1612

rawListeners

rawListeners<P, T>(this: T, event: P): Function[]
Type Parameters
- P extends keyof RtmClientEvents
- T
Parameters
- this: T
- event: P
Returns Function[]
Inherited from EventEmitter.rawListeners
- Defined in node_modules/agora-rtm-sdk/index.d.ts:199

removeAllListeners

removeAllListeners<P, T>(this: T, event?: P): RtmClient
Type Parameters
- P extends keyof RtmClientEvents
- T
Parameters
- this: T
- Optional event: P
Returns RtmClient
Inherited from EventEmitter.removeAllListeners
- Defined in node_modules/agora-rtm-sdk/index.d.ts:197

renewToken

renewToken(token: string): Promise<void>
Renews the token.
Parameters
- token: string
  
  Your new Token.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1624

sendMessageToPeer

sendMessageToPeer(message: RtmMessage, peerId: string, options?: SendMessageOptions): Promise<PeerMessageSendResult>
Allows a user to send an (offline) peer-to-peer message to a specified remote user.

You can send messages, including peer-to-peer and channel messages at a maximum frequency of 180 calls every three second.

Example
```
client.sendMessageToPeer(
  { text: 'test peer message' }, // An RtmMessage object.
  'demoPeerId', // The uid of the remote user.
).then(sendResult => {
  if (sendResult.hasPeerReceived) {
    // Your code for handling the event when the remote user receives the message.
  } else {
    // Your code for handling the event when the message is received by the server but the remote user cannot be reached.
  }
}).catch(error => {
  // Your code for handling the event when the message fails to be sent.
});
```
Returns
The Promise resolves after the message is successfully sent. The value of the Promise indicates whether the peer user is online and receives the message.
Parameters
- message: RtmMessage
  
  The message to be sent.
- peerId: string
  
  The uid of the peer user.
- Optional options: SendMessageOptions
  
  Enables offline messaging. See SendMessageOptions.
  
  Note
  We do not support uids of the number type. We recommend using the toString() method to convert a non-string uid.
Returns Promise<PeerMessageSendResult>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1470

setChannelAttributes

setChannelAttributes(channelId: string, attributes: AttributesMap, options?: ChannelAttributeOptions): Promise<void>
Sets the attributes of a specified channel with new ones.

Note
- You do not have to join the specified channel to reset its attributes.
- The attributes of a channel will be cleared if the channel remains empty (has no members) for a couple of minutes.
- For setLocalUserAttributes, addOrUpdateChannelAttributes, deleteChannelAttributesByKeys, and clearChannelAttributes taken together: the call frequency limit is 10 calls every five seconds.
Parameters
- channelId: string
  
  The channel ID of the specified channel.
- attributes: AttributesMap
  
  An array of channel attributes.
- Optional options: ChannelAttributeOptions
  
  Options for this attribute operation. See ChannelAttributeOptions.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1850

setLocalUserAttributes

setLocalUserAttributes(attributes: AttributesMap): Promise<void>
Substitutes the local user's attributes with new ones.

Returns
The Promise resolves after successfully setting the local user's attributes.
Parameters
- attributes: AttributesMap
  
  The new attributes.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1527

setParameters

setParameters(config: RtmConfig): void
Modifies the RtmClient instance configuration. The changes take effect immediately.

Deprecated
This method is deprecated as of v1.4.2. Please use updateConfig instead.
Parameters
- config: RtmConfig
  
  Sets whether the SDK uploads logs, and sets the output level of logs. See RtmConfig.
Returns void
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1654

subscribePeersOnlineStatus

subscribePeersOnlineStatus(peerIds: string[]): Promise<void>
Subscribes to the online status of the specified users.
- When the method call succeeds, the SDK returns the PeersOnlineStatusChanged callback to report the online status of peers, to whom you subscribe.
- When the online status of the peers, to whom you subscribe, changes, the SDK returns the PeersOnlineStatusChanged callback to report whose online status has changed.
- If the online status of the peers, to whom you subscribe, changes when the SDK is reconnecting to the server, the SDK returns the PeersOnlineStatusChanged callback to report whose online status has changed when successfully reconnecting to the server.
Note
- When you log out of the Agora RTM system, all the status that you subscribe to will be cleared. To keep the original subscription after you re-log in the system, you need to redo the whole subscription process.
- When the SDK reconnects to the server from the state of being interrupted, the SDK automatically subscribes to the peers and states before the interruption without human intervention.
Parameters
- peerIds: string[]
  
  An array of the specified user IDs.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1884

unsubscribePeersOnlineStatus

unsubscribePeersOnlineStatus(peerIds: string[]): Promise<void>
Unsubscribes from the online status of the specified users.
Parameters
- peerIds: string[]
  
  An array of the specified user IDs.
Returns Promise<void>
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1896

updateConfig

updateConfig(config: RtmConfig): void
Modifies the RtmClient instance configuration. The changes take effect immediately.
Parameters
- config: RtmConfig
  
  Sets whether the SDK uploads logs, and sets the output level of logs. See RtmConfig.
Returns void
- Defined in node_modules/agora-rtm-sdk/index.d.ts:1636

Class RtmClient

No Inherit Doc

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Returns RtmClient

Properties

Static defaultMaxListeners

Methods

addOrUpdateChannelAttributes

Parameters

channelId: string

attributes: AttributesMap

Optional options: ChannelAttributeOptions

Returns Promise<void>

addOrUpdateLocalUserAttributes

Returns

Parameters

attributes: AttributesMap

Returns Promise<void>

clearChannelAttributes

Parameters

channelId: string

Optional options: ChannelAttributeOptions

Returns Promise<void>

clearLocalUserAttributes

Returns

Returns Promise<void>

createChannel

Returns

Parameters

channelId: string

Returns RtmChannel

createLocalInvitation

Returns

Parameters

calleeId: string

Returns LocalInvitation

createMediaMessageByUploading

Example

Returns

Parameters

payload: Blob

Optional params: { description?: string; fileName?: string; messageType?: "FILE"; thumbnail?: Blob; }

Optional description?: string

Optional fileName?: string

Optional messageType?: "FILE"

Optional thumbnail?: Blob

Optional transHandler: MediaTransferHandler

Returns Promise<RtmFileMessage>

Example

Returns

Parameters

payload: Blob

Optional params: { description?: string; fileName?: string; height?: number; messageType?: "IMAGE"; thumbnail?: Blob; thumbnailHeight?: number; thumbnailWidth?: number; width?: number; }

Optional description?: string

Optional fileName?: string

Optional height?: number

Optional messageType?: "IMAGE"

Optional thumbnail?: Blob

Optional thumbnailHeight?: number

Optional thumbnailWidth?: number

Optional width?: number

Optional transHandler: MediaTransferHandler

Returns Promise<RtmImageMessage>

createMessage

Example

Returns

Type Parameters

T extends RtmMessage

Parameters

message: Partial<T>

Returns T

deleteChannelAttributesByKeys

Parameters

channelId: string

`Static` defaultMaxListeners

`Optional` options: ChannelAttributeOptions

`Optional` options: ChannelAttributeOptions

`Optional` params: {
description?: string;
fileName?: string;
messageType?: "FILE";
thumbnail?: Blob;
}

`Optional` description?: string

`Optional` fileName?: string

`Optional` messageType?: "FILE"

`Optional` thumbnail?: Blob

`Optional` transHandler: MediaTransferHandler

`Optional` params: {
description?: string;
fileName?: string;
height?: number;
messageType?: "IMAGE";
thumbnail?: Blob;
thumbnailHeight?: number;
thumbnailWidth?: number;
width?: number;
}

`Optional` description?: string

`Optional` fileName?: string

`Optional` height?: number

`Optional` messageType?: "IMAGE"

`Optional` thumbnail?: Blob

`Optional` thumbnailHeight?: number

`Optional` thumbnailWidth?: number

`Optional` width?: number

`Optional` transHandler: MediaTransferHandler

`Optional` options: ChannelAttributeOptions

`Optional` transHandler: MediaTransferHandler

options: {
token?: string;
uid: string;
}

`Optional` token?: string