QChatRTCChannelListener.java

浏览该文件的文档.

package com.netease.nimlib.sdk.qcmedia;

import com.netease.nimlib.sdk.qcmedia.enums.QChatMediaAudioOuputDevice;
import com.netease.nimlib.sdk.qcmedia.enums.QChatMediaEndReason;
import com.netease.nimlib.sdk.qcmedia.model.QChatMemberVolumeInfo;
import java.util.List;

/**
 *  RTC频道事件监听器
 */
public interface QChatRTCChannelListener {
    /**
     * 成员进入RTC频道回调
     * @param memberAccids 成员accid列表
     */
    void onMemberJoinRTCChannel(List<String> memberAccids);

    /**
     * 成员离开RTC频道回调
     * @param memberAccids 成员accid列表
     */
    void onMemberLeaveRTCChannel(List<String> memberAccids);

    /**
     * RTC频道结束回调
     * @param reason RTC频道结束的原因
     * @see QChatMediaEndReason
     */
    void onRTCChannelEnded(QChatMediaEndReason reason);

    /**
     * RTC频道错误回调
     * @param code RTC错误码
     */
    void onRtcChannelError(int code);

    /**
     * 提示RTC频道内谁正在说话及说话者瞬时音量的回调。该回调默认为关闭状态。
     * 可以通过 [QChatRTCChannelController.enableAudioVolumeIndication] 方法开启。
     * 开启后，无论RTC频道内是否有人说话，SDK 都会按设置的时间间隔触发该回调。
     * - 如果有 [QChatMemberVolumeInfo.userUuid] 出现在上次返回的列表中，但不在本次返回的列表中，则默认该 userId 对应的远端用户没有说话。
     * - 如果 [QChatMemberVolumeInfo.volume] 为 0，表示该用户没有说话。
     * - 如果列表为空，则表示此时远端没有人说话。
     * - 如果是本地用户的音量回调，则[volumes]中只会包含本端用户
     * @param volumes 每个说话者的用户 ID 和音量信息的列表
     * @param totalVolume 混音后的总音量，取值范围为 0~100。
     */
    void onRtcAudioVolumeIndication(List<QChatMemberVolumeInfo> volumes, int totalVolume);

    /**
     * 本端音频输出设备变更通知，如切换到扬声器、听筒、耳机等
     * @param device 音频输出类型
     */
    void onRtcAudioOutputDeviceChanged(QChatMediaAudioOuputDevice device);

    /**
     * 成员音频状态回调
     * @param memberAccid 成员accid
     * @param mute 是否静音。true 静音打开，false 静音关闭
     * @param operateAccid 操作者accid
     */
    void onMemberAudioMuteChanged(String memberAccid, boolean mute, String operateAccid);

    /**
     * 成员视频状态回调
     * @param memberAccid 成员accid
     * @param mute 是否关闭视频。true 关闭视频，false 打开视频
     * @param operateAccid 操作者accid
     */
    void onMemberVideoMuteChanged(String memberAccid, boolean mute, String operateAccid);

    /**
     * 成员屏幕共享状态回调
     * @param memberAccid 成员accid
     * @param isSharing 是否正在进行屏幕共享。true 表示房间内有人正在屏幕共享，false 表示房间内没有有人正在屏幕共享
     * @param operateAccid 操作者
     */
    void onMemberScreenShareStateChanged(String memberAccid, boolean isSharing, String operateAccid);

}