通知
RTM 1.x 将于近期下架，各版本退休日期和替代方案详见 退休政策 。
Documentation
Real-time Messaging
Console 官网 Community Technical support
English
search-icon

Agora RTM Web API Reference

Index AgoraRTM RtmClient RtmMessage RtmChannel LocalInvitation RemoteInvitation RtmEvents RtmErrorCode RtmStatusCode

The RTM channel instance created by calling the createChannel method of the RtmClient instance.

Hierarchy

Index

Properties

Methods

Properties

channelId

channelId: string
readonly

Retrieves the ID of the RTM channel instance.

Methods

getMembers

  • getMembers(): Promise<string[]>

  • Gets the member list of the channel.

    Returns Promise<string[]>

    The Promise resolves after the user gets the member list of the channel in an array with the channel's uids.

join

  • join(): Promise<void>

  • Allows a user to join a channel. After joining the channel, the user can receive channel messages and notifications of other users joining or leaving the channel.

    You can join a maximum of 20 channels.

    Returns Promise<void>

    The Promise resolves after the user successfully joins the channel.

leave

  • leave(): Promise<void>

  • Allows a user to leave a joined channel. After leaving the channel, the user does not receive channel messages or notifications of users joining or leaving the channel.

    Returns Promise<void>

    The Promise resolves after the user successfully leaves the channel.

on

  • on<EventName>(eventName: EventName, listener: function): this

  • Adds the listener function to the channel for the event named eventName. See the EventEmitter API documentation for other event methods on the RtmChannel instance.

    Type parameters

    • EventName: keyof RtmChannelEvents

    Parameters

    • eventName: EventName

      The name of the channel event. See the property names in the RtmChannelEvents for the list of events.

    • listener: function

      The callback function of the channel event.

        • (...args: ListenerType<RtmChannelEvents[EventName]>): any

        • Parameters

          • Rest ...args: ListenerType<RtmChannelEvents[EventName]>

          Returns any

    Returns this

sendMessage

  • Allows a user to send a message to all users in a channel.

    You can send messages, including peer-to-peer and channel messages at a maximum speed of 60 queries per second.

    example

    Sending a channel message.

    channel.sendMessage({ text: 'test channel message' }).then(() => {
// Your code for handling the event when the channel message is successfully sent.
}).catch(error) => {
// Your code for handling the event when the channel message fails to be sent.
})

    Parameters

    Returns Promise<void>

    The Promise resolves after the user successfully sends a channel message.