tencent cloud

Feedback

TUIRoomObserver

Last updated: 2023-10-30 11:01:03

    TUIRoomObserver Callback Event Details

    The TUIRoomObserver class is the corresponding Callback Event class for TUIRoomEngine. You can listen to the Callback Events you are interested in through this Callback Interface.

    onError

    Error Event Callback
    virtual void onError(TUIError errorCode, const char* message) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    errorCode
    TUIError
    Error Code
    message
    const char*
    Error Message

    onKickedOffLine

    Other terminals login and get kicked off event.
    virtual void onKickedOffLine(const char* message) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    message
    const char*
    Kicked out description

    onUserSigExpired

    User credential timeout event.
    virtual void onUserSigExpired() = 0;

    onRoomNameChanged

    Room name change event.
    virtual void onRoomNameChanged(const char* roomId, const char* roomName) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    roomName
    const char*
    Room Name

    onAllUserMicrophoneDisableChanged

    Inside the room, all users' mic is disabled event.
    virtual void onAllUserMicrophoneDisableChanged(const char* roomId, bool isDisable) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    isDisable
    bool
    Whether it is disabled

    onAllUserCameraDisableChanged

    All users' Camera in the Room are disabled event.
    virtual void onAllUserCameraDisableChanged(const char* roomId, bool isDisable) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    isDisable
    bool
    Whether it is disabled

    onSendMessageForAllUserDisableChanged

    Inside the room, all users' text message sending is disabled event.
    virtual void onSendMessageForAllUserDisableChanged(const char* roomId, bool isDisable) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    isDisable
    bool
    Whether it is disabled

    onRoomDismissed

    Room dissolution event.
    virtual void onRoomDismissed(const char* roomId) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID

    onKickedOutOfRoom

    Kicked out of the room event.
    virtual void onKickedOutOfRoom(const char* roomId, const char* message) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    message
    const char*
    Description of being kicked out

    onRoomSpeechModeChanged

    Mic control mode changes in the room.
    virtual void onRoomSpeechModeChanged(const char* roomId, TUISpeechMode speechMode) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    speechMode
    TUISpeechMode
    Mic control mode

    onRemoteUserEnterRoom

    Remote user enters the room event.
    virtual void onRemoteUserEnterRoom(const char* roomId, const TUIUserInfo& userInfo) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    userInfo
    const TUIUserInfo&
    User information

    onRemoteUserLeaveRoom

    Remote user leaves the room event.
    virtual void OnRemoteUserLeaveRoom(const char* roomId, const TUIUserInfo& userInfo) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    userInfo
    const TUIUserInfo&
    User information

    onUserRoleChanged

    User role changes event.
    virtual void onUserRoleChanged(const char* userId, const TUIRole& userRole) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    userId
    const char*
    User ID
    userRole
    const TUIRole&
    User Role

    onUserVideoStateChanged

    User Video status changes event.
    virtual void onUserVideoStateChanged(const char* userId, TUIVideoStreamType streamType, bool hasVideo, TUIChangeReason reason) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    userId
    const char*
    User ID
    streamType
    TUIVideoStreamType
    Streams type
    hasVideo
    bool
    Whether there are streams
    reason
    TUIChangeReason
    Reason for streams change

    onUserAudioStateChanged

    User Audio status changes event.
    virtual void onUserAudioStateChanged(const char* userId, bool hasAudio, TUIChangeReason reason) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    userId
    const char*
    User ID
    hasAudio
    bool
    Whether there are Audio streams
    reason
    TUIChangeReason
    Reason for Audio streams change

    onUserVoiceVolumeChanged

    User volume change event.
    virtual void onUserVoiceVolumeChanged(TUIMap<const char*, int>* volumeMap) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    volumeMap
    TUIMap<const char*, int>*
    User Volume Map

    onSendMessageForUserDisableChanged

    User text message sending ability changes event.
    virtual void onSendMessageForUserDisableChanged(const char* roomId, const char* userId, bool isDisable) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    userId
    const char*
    User ID
    isDisable
    bool
    Whether the user is prohibited from sending messages, true: The user is prohibited from sending text and custom messages; false: The user is allowed to send text and custom messages.

    onUserNetworkQualityChanged

    User network status change event.
    virtual void onUserNetworkQualityChanged(TUIList<TUINetwork>* networkList) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    networkList
    TUIList<TUINetwork>*
    User network status list

    onUserScreenCaptureStopped

    Screen Sharing stopped Callback event.
    virtual void onUserScreenCaptureStopped(int reason) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    reason
    int
    Stop reason:
    0: User actively stops
    1: Screen window closing causes the stop
    2: Screen Sharing display screen status change (such as interface being unplugged, Projection mode change, etc.)

    onRoomMaxSeatCountChanged

    Maximum number of mic slots changes event in the room (only effective in meeting type rooms).
    virtual void onRoomMaxSeatCountChanged(const char* roomId, int maxSeatCount) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    maxSeatCount
    int
    Maximum number of mic slots in the room

    onSeatListChanged

    Mic slot list changes event.
    virtual void onSeatListChanged(TUIList<TUISeatInfo>* seatList, TUIList<TUISeatInfo>* usersSeated, TUIList<TUISeatInfo>* usersLeft) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    seatList
    TUIList<TUISeatInfo>*
    The latest user list on the mic, including newly on mic users
    usersSeated
    TUIList<TUISeatInfo>*
    Newly on mic user list
    usersLeft
    TUIList<TUISeatInfo>*
    Newly off mic user list

    onKickedOffSeat

    Received the event of user being kicked off mic.
    virtual void onKickedOffSeat(const char* userId) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    userId
    const char*
    User ID

    onRequestReceived

    Received request message event.
    virtual void onRequestReceived(const TUIRequest* request) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    request
    const TUIRequest*
    Request content

    onRequestCancelled

    Received request cancellation event.
    virtual void OnRequestCancelled(const char* requestId, const char* userId) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    requestId
    const char*
    Request ID
    userId
    const char*
    User ID

    onReceiveTextMessage

    Received ordinary text message event.
    virtual void onReceiveTextMessage(const char* roomId, const TUIMessage& message) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    message
    const TUIMessage&
    Message content

    onReceiveCustomMessage

    Received custom message event.
    virtual void onReceiveCustomMessage(const char* roomId, const TUIMessage& message) = 0;
    The parameters are as follows:
    Parameter
    Type
    Meaning
    roomId
    const char*
    Room ID
    message
    const TUIMessage&
    Message content
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support