通过阅读本文,您可以了解到Android SDK的AliRtcEngine接口详情。

接口说明

查看所有接口详情,请参见AliRtcEngine

目录

基础接口

API描述支持的最低版本
setH5CompatibleMode设置H5兼容模式。1.1
getH5CompatibleMode检查当前是否兼容H5。1.1
getInstance创建AliRtcEngine实例(同一时间只会存在一个实例),只能在主线程调用。1.17
getInstance创建AliRtcEngine实例,支持通过传入参数配置SDK特别功能(同一时间只会存在一个实例),只能在主线程调用。1.17
destroy销毁SDK。1.1
uploadLog主动上传日志。1.1
setRtcEngineEventListener设置本地用户行为的回调事件的监听。1.1
setRtcEngineNotify设置远端用户行为的通知事件的监听。1.1

频道相关接口

API描述支持的最低版本
joinChannel加入频道。1.1
leaveChannel离开频道。1.1
switchChannel切换频道2.1
isInCall检查当前是否在频道中。1.1
setChannelProfile设置频道模式。1.15
createChannel创建AliRtcEngine子频道实例。2.1
destroyChannel销毁子频道实例。2.1

发布相关接口

API描述支持的最低版本
publishLocalVideoStream设置是否发布视频流。2.1
isLocalVideoStreamPublished查询当前是否发布视频流。1.1
isScreenSharePublished查询当前是否发布屏幕流。1.1
publishLocalAudioStream设置是否发布音频流。2.1
isLocalAudioStreamPublished查询当前是否推音频流。1.1
publishLocalDualStream设置是否发布次要视频流。2.1
isDualStreamPublished查询当前是否发布次要视频流。2.1

订阅相关接口

API描述支持的最低版本
setRemoteVideoStreamType设置订阅的相机流格式,大流或小流。2.1
setRemoteDefaultVideoStreamType设置默认订阅的相机流格式,大流或小流。2.1
setDefaultSubscribeAllRemoteAudioStreams设置是否默认接收音频流。2.1
subscribeAllRemoteAudioStreams停止或恢复接收所有远端音频流。2.1
subscribeRemoteAudioStream停止或恢复特定远端用户的音频流拉取。2.1
setDefaultSubscribeAllRemoteVideoStreams设置是否默认接收视频流。2.1
subscribeAllRemoteVideoStreams停止或恢复接收所有远端视频流。2.1
subscribeRemoteVideoStream停止或恢复特定远端用户的视频流拉取。2.1

视频相关接口

API描述支持的最低版本
createRenderSurfaceView创建SurfaceView渲染视图。2.1
createRenderTextureView创建TextureView渲染视图。2.1
setScreenShareEncoderConfiguration设置屏幕共享编码属性。2.1
setLocalViewConfig为本地预览设置渲染窗口以及绘制参数。1.1
setCameraCapturerConfiguration设置摄像头采集偏好。2.1
enableLocalVideo禁用或重新启用本地视频采集。2.1
muteLocalCamera设置是否停止发布本地视频流。1.1
muteAllRemoteVideoRendering停止或恢复远端所有的视频渲染。2.1
setRemoteViewConfig为远端的视频设置渲染窗口以及绘制参数。1.1
isCameraOn检查摄像头是否打开。1.1
stopRecord停止录制。1.17
startRecord开始录制。1.17
setBeautyEffect设置基础美颜。1.17.9
setVideoEncoderConfiguration设置视频编码属性。2.1
addVideoWatermark添加水印。2.1
clearVideoWatermark清理对应数据流水印信息。2.1
snapshotVideo截图。2.1
switchCamera切换前后摄像头(默认为前置摄像头)。1.1
getCurrentCameraDirection获取当前摄像头方向。1.1
setCameraZoom设置摄像头缩放比例。1.1
setCameraFlash设置摄像头闪光灯是否打开。1.14
setCameraFocusPoint设置摄像头手动聚焦。1.14
setCameraExposurePoint设置摄像头曝光点。1.14
isCameraAutoFocusFaceModeSupported摄像头是否支持人脸聚焦。2.1
setCameraAutoFocusFaceModeEnabled设置摄像头人脸对焦。2.1
getVideoCaptureData主动获取采集数据。2.4
getVideoPreEncoderData主动获取编码前数据。2.4
getVideoRenderData主动获取拉流数据。2.4

共享视频接口

API描述支持的最低版本
startScreenShare开始屏幕分享。2.1
startScreenShare开始屏幕分享。2.1
stopScreenShare停止屏幕分享。2.1

音频相关接口

API描述支持的最低版本
setAudioOnlyMode设置为纯音频模式还是音视频模式。1.1
isAudioOnly查询当前是否为纯音频模式。1.1
muteLocalMic设置是否停止发布本地音频。1.1
muteRemoteAudioPlaying设置是否停止播放远端音频流。1.1
muteAllRemoteAudioPlaying停止或恢复远端所有的音频播放。1.16.2
startAudioCapture开启音频采集。1.1
startAudioCapture开启音频采集2.2
stopAudioCapture关闭音频采集。1.1
startAudioPlayer开启音频播放设备。1.1
stopAudioPlayer关闭音频播放。1.1
setRemoteAudioVolume设置本地播放的指定远端用户音量。2.1
enableSpeakerphone设置音频输出为听筒还是扬声器。2.1
isSpeakerOn获取当前音频输出为听筒还是扬声器。2.1
setRecordingVolume设置录音音量。1.16.2
setPlayoutVolume设置播放音量。1.16.2
enableAudioVolumeIndication设置音量回调频率和平滑系数。1.17.9
setAudioProfile设置音频Profile。2.1
enableAudioDTX开启本地音频流量控制(语音)。2.1
enableAudioAMD开启本地音频流量控制(麦克风)。2.1
setAudioEffectVoiceChangerMode设置变声音效模式。2.1
setAudioEffectPitchValue设置变调参数。2.1
setAudioEffectReverbMode设置混响音效模式。2.1
setAudioEffectReverbParamType设置混响音效类型和具体参数。2.1
startAudioAccompany开始混音。1.15
stopAudioAccompany停止混音。1.15
setAudioAccompanyVolume设置混音音量。1.15
setAudioAccompanyPublishVolume设置混音之后推流出去的音量。1.15
getAudioAccompanyPublishVolume获取推流出去的混音音量。1.15
setAudioAccompanyPlayoutVolume设置混音之后本地播放的音量。1.15
getAudioAccompanyPlayoutVolume获取混音本地播放的音量。1.15
pauseAudioAccompany暂停混音。1.15
resumeAudioAccompany重新开始混音。1.15
getAudioAccompanyDuration获取伴奏文件时长。1.17.30
getAudioAccompanyCurrentPosition获取音乐文件播放进度。1.17.30
setAudioAccompanyPosition设置音频文件的播放位置。1.17.30
preloadAudioEffect预加载音效文件。1.15
unloadAudioEffect删除预加载的音效文件。1.15
playAudioEffect开始播放音效。1.15
stopAudioEffect停止播放音效。1.15
stopAllAudioEffects停止播放所有音效。1.15
setAudioEffectPublishVolume设置音效推流音量。1.15
getAudioEffectPublishVolume获取推流音效音量。1.15
setAudioEffectPlayoutVolume设置音效本地播放音量。1.15
getAudioEffectPlayoutVolume获取音效本地播放音量。1.15
setAllAudioEffectsPublishVolume设置所有音效推流混音音量。1.15
setAllAudioEffectsPlayoutVolume设置所有音效本地播音量。1.15
pauseAudioEffect暂停音效。1.15
pauseAllAudioEffects暂停所有音效。1.15
resumeAudioEffect重新开始播放音效。1.15
resumeAllAudioEffects重新开始播放所有音效。1.15
enableEarBack启用耳返。1.15
setEarBackVolume设置耳返音量。1.15
requestAudioFocus请求音频焦点。1.17.19
abandonAudioFocus放弃音频焦点。1.17.19

媒体引擎接口

API描述支持的最低版本
registerVideoSampleObserver注册视频数据输出对象。1.17
unRegisterVideoSampleObserver取消注册视频数据输出对象。1.17
registerLocalVideoTextureObserver注册本地相机流视频OpenGL纹理数据观测器。1.15
unRegisterLocalVideoTextureObserver取消注册本地相机流视频OpenGL纹理数据观测器。1.15
registerAudioObserver订阅音频数据输出。1.17
unRegisterAudioObserver取消音频数据输出。1.17
setSubscribeAudioNumChannel设置输出音频声道数。2.1
setSubscribeAudioSampleRate设置输出音频采样率。2.1
registerAudioVolumeObserver注册音量数据输出对象。1.16.2
unRegisterAudioVolumeObserver取消音量数据输出对象注册。1.16.2
setExternalVideoSource启用外部视频输入源。2.1
pushExternalVideoFrame输入视频数据。2.1
setExternalAudioSource设置是否启用外部音频输入源。1.17.9
pushExternalAudioFrameRawData输入音频数据。1.17.9
setExternalAudioVolume设置外部音频音量。1.17.9
getExternalAudioVolume获取混音音量。1.17.9
setMixedWithMic设置外部音频输入是否与麦克风采集音频混合。1.17.9
setExteranlAudioRender设置是否启用外部输入音频播放。1.17.9
pushExternalAudioRenderRawData输入外部音频播放数据。1.17.9

直播旁路接口

API描述支持的最低版本
startPublishLiveStream开启旁路直播。2.4
updatePublishLiveStream更新旁路直播相关参数。2.4
stopPublishLiveStream停止旁路直播。2.1
getPublishLiveStreamState获取旁路直播状态。2.4

跨频道连麦接口

API描述支持的最低版本
startChannelRelay开启跨频道连麦。2.1
updateChannelRelay更新跨频道连麦。2.1
stopChannelRelay停止跨频道连麦。2.1

预览接口

API描述支持的最低版本
startPreview开始本地预览。1.1
stopPreview停止本地预览。1.1

远端用户查询接口

API描述支持的最低版本
getOnlineRemoteUsers获取远端在线用户列表。1.1
getUserInfo查询远端用户信息。1.1
isUserOnline查询用户是否在线。1.1

其他接口

API描述支持的最低版本
setLogDirPath设置SDK日志文件保存路径。1.17
setLogLevel设置日志级别。1.1
getSdkVersion获取SDK版本号。2.4
getErrorDescription获取错误码描述。2.1
setClientRole设置用户角色。1.16
getCurrentClientRole获取用户角色。1.17.19
startNetworkQualityProbeTest开始网络质量探测。1.16.2
stopNetworkQualityProbeTest停止网络质量探测。1.16.2
respondMessageNotification发送下行通道消息。2.1
uplinkChannelMessage发送上行通道消息。2.1
postFeedbackSDK问题反馈。1.17.12
sendMediaExtensionMsg发送媒体扩展信息。1.17.1
startIntelligentDenoise开启智能降噪。1.17.19
stopIntelligentDenoise关闭智能降噪。1.17.19
refreshAuthInfo刷新鉴权信息。1.17.41
getCurrentConnectionStatus获取当前网络链接状态。2.1
showDebugView显示仪表盘。2.4

接口详情

  • setH5CompatibleMode:设置是否兼容H5。
    public static int setH5CompatibleMode(int enable);
    参数说明
    参数类型描述
    enableint设置是否兼容H5,取值:
    • 0(默认值):不兼容H5。
    • 1:兼容H5。
    重要 当前版本不支持在创建AliRtcEngine实例之后更改H5兼容模式,必须在创建实例之前就调用此接口。
  • getH5CompatibleMode:检查当前是否兼容H5。
    public static int getH5CompatibleMode();
    返回说明

    1表示兼容H5,0表示不兼容H5。

  • getInstance:获取一个AliEngineEngine实例。
    public static AliRtcEngineImpl getInstance(Context context);
    参数说明
    参数类型描述
    contextContext安卓(Android Activity)的上下文。
    重要 同一时间只会存在一个主实例,只能在主线程调用。
  • getInstance:获取一个AliEngineEngine实例。
    public static AliRtcEngineImpl getInstance(Context context,String extras);

    支持通过传入参数配置SDK特别功能。

    参数说明
    参数类型描述
    contextContext安卓(Android Activity)的上下文。
    extrasString通过JSON配置SDK的特别功能,更多信息,请参见extras参数配置说明。无需特别功能,可填空字符:@""。
    重要 同一时间只会存在一个主实例,只能在主线程调用。
  • destroy:销毁SDK实例。
    public abstract void destroy();
    重要 在所有操作结束之后调用。
  • uploadLog:上传日志。默认离会自动上传。
    public static void uploadLog();
  • setRtcEngineEventListener:设置本地用户行为的通知事件的监听。
    public abstract void setRtcEngineEventListener(AliRtcEngineEventListener listener);
    参数说明
    参数类型描述
    listenerAliRtcEngineEventListener设置本地用户行为的通知事件的监听。
  • setRtcEngineNotify:设置远端用户行为的通知事件的监听。
    public abstract void setRtcEngineNotify(AliRtcEngineNotify listener);
    参数说明
    参数类型描述
    listenerAliRtcEngineEventListener设置远端用户行为的通知事件的监听。
  • joinChannel:加入频道。
    public abstract int joinChannel(AliRtcAuthInfo authInfo, String userName);

    加入频道成功后,如果中途需要加入其他频道,必须先调用leaveChannel离开当前频道,如果加入频道失败,需要重试时,无需先调用leaveChannel

    参数说明
    参数类型描述
    authInfoAliRtcAuthInfo鉴权信息。
    userNameString用户的显示名称(不是用户ID)。
    返回说明

    0表示方法调用成功,非0表示方法调用失败。

    重要 该接口是异步接口,是否成功加入频道,需要通过onJoinChannelResult回调判断。
  • leaveChannel:离开频道。
    public abstract int leaveChannel();
    返回说明

    0表示方法调用成功,非0表示方法调用失败。

    说明 1.15及以上版本,销毁引擎只能通过destroy接口。1.15以下版本,离开频道时,AliEngine实例会被销毁,如需继续加入频道等操作,需要重新调用getInstance接口初始化AliEngine实例。

    如果当前不在频道内,调用leaveChannel不会对实例产生任何影响,但会产生消息,通知频道内其他用户。

  • switchChannel:切换频道。
    public abstract int switchChannel(AliRtcAuthInfo authInfo);
    参数说明
    参数类型描述
    authInfoAliRtcAuthInfo鉴权信息。
    返回说明

    此接口仅在互动模式AliRTCSdkInteractiveLive下使用,观看角色AliRTCSdkLive使用。

    此接口为异步接口,调用成功切换频道后,SDK会先触发离开原频道的回调onLeaveChannelResult,在返回加入新频道的回调onJoinChannelResult

    0表示方法调用成功,非0表示方法调用失败。

    • 返回ERR_SDK_INVALID_STATE请确认是否因为频道模式或角色不匹配,或者当前未加入任何频道中。
    • 返回ERR_INVALID_ARGUMENTS请确认鉴权信息是否合法,或者是否加入相同频道。
    • 返回ERR_INNER为SDK内部状态错误。
  • isInCall:检查当前是否在频道中。
    public abstract boolean isInCall();
    返回说明

    true表示在频道中,false表示不在频道中。

  • setChannelProfile:设置频道模式。
    public abstract int setChannelProfile(AliRTCSdkChannelProfile channelProfile);
    参数说明
    参数类型描述
    channelProfileAliRTCSdkChannelProfile频道类型。默认值为AliEngineCommunication。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

    重要 该接口只可以在加入频道之前调用,会议中不可以重新设置,离开频道后可以重新设置。
  • createChannel:创建一个AliEngine子频道实例。
    public abstract AliRtcEngine createChannel(String extras);
    参数说明
    参数类型描述
    extrasString通过JSON配置SDK的特别功能,更多信息,请参见extras参数配置说明。无需特别功能,可填空字符:@""。
    返回说明

    成功返回子频道实例,失败返回null。

  • destroyChannel:销毁CreateChannel创建的子频道。
    public abstract void destroyChannel();
  • publishLocalVideoStream:设置是否发布相机流。
    public abstract int publishLocalVideoStream(boolean enable);
    参数说明
    参数类型描述
    enableboolean是否发布相机流,取值:
    • true(默认值):发布相机流。
    • false:不发布相机流。
  • isLocalVideoStreamPublished:查询当前是否发布相机流。
    public abstract boolean isLocalVideoStreamPublished();
    返回说明

    true表示发布相机流,false表示不发布相机流。

  • isScreenSharePublished:查询当前是否发布屏幕流。
    public abstract boolean isScreenSharePublished();
    返回说明

    true表示发布屏幕流,false表示未发布屏幕流。

  • publishLocalAudioStream:设置是否发布音频流。
    public abstract int publishLocalAudioStream(boolean enable);
    参数说明
    参数类型描述
    enableboolean是否发布音频流,取值:
    • true(默认值):发布音频流。
    • false:不发布音频流。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • isLocalAudioStreamPublished:查询当前是否发布音频流。
    public abstract boolean isLocalAudioStreamPublished();
    返回说明

    true表示发布音频流,false表示不发布音频流。

  • publishLocalDualStream:设置是否发布次要视频流。
    public abstract int publishLocalDualStream(boolean enable);
    参数说明
    参数类型描述
    enableboolean是否发布次要视频流,取值:
    • true:发布次要视频流。
    • false(默认值):不发布次要视频流。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • isDualStreamPublished:查询当前是否发布次要视频流。
    public abstract boolean isDualStreamPublished();
    返回说明

    true表示发布次要视频流,false表示不发布次要视频流。

  • setRemoteVideoStreamType:设置订阅的相机流格式,大流或小流。
    public abstract int setRemoteVideoStreamType(String uid, AliRtcVideoStreamType streamType);
    参数说明
    参数类型描述
    uidString远端用户ID。
    streamTypeAliRtcVideoStreamType相机流格式。默认值为AliRtcVideoStreamTypeHigh(大流)。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setRemoteDefaultVideoStreamType:设置默认订阅的相机流格式,大流或小流。
    public abstract int setRemoteDefaultVideoStreamType(AliRtcVideoStreamType streamType);
    参数说明
    参数类型描述
    streamTypeAliRtcVideoStreamType相机流格式。默认值为AliRtcVideoStreamTypeHigh(大流)。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setDefaultSubscribeAllRemoteAudioStreams:设置是否默认接收音频流。
    public abstract int setDefaultSubscribeAllRemoteAudioStreams(boolean sub);
    参数说明
    参数类型描述
    subboolean是否默认接收音频流,取值:
    • true(默认值):默认接收音频流。
    • false:默认不接收音频流。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • subscribeAllRemoteAudioStreams:设置是否接收所有远端音频流。
    public abstract int subscribeAllRemoteAudioStreams(boolean sub);
    参数说明
    参数类型描述
    subboolean是否接收所有远端音频流,取值:
    • true(默认值):接收所有远端音频流。
    • false:不接收所有远端音频流。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • subscribeRemoteAudioStream:停止或恢复特定远端用户的音频流拉取。
    public abstract int subscribeRemoteAudioStream(String uid, boolean sub);
    参数说明
    参数类型描述
    uidString远端用户ID。
    subboolean停止或恢复特定远端用户的音频流拉取,取值:
    • true(默认值):恢复。
    • false:停止。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setDefaultSubscribeAllRemoteVideoStreams:设置是否默认接收视频流。
    public abstract int setDefaultSubscribeAllRemoteVideoStreams(boolean sub);
    参数说明
    参数类型描述
    subboolean是否默认接收视频流,取值:
    • true(默认值):默认接收。
    • false:默认不接收。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • subscribeAllRemoteVideoStreams:停止或恢复接收所有远端视频流。
    public abstract int subscribeAllRemoteVideoStreams(boolean sub);
    参数说明
    参数类型描述
    subboolean停止或恢复接收所有远端视频流,取值:
    • true(默认值):恢复。
    • false:停止。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • subscribeRemoteVideoStream:停止或恢复特定远端用户的视频流拉取。
    public abstract int subscribeRemoteVideoStream(String uid, AliRtcVideoTrack track, boolean sub);
    参数说明
    参数类型描述
    uidSrring远端用户ID。
    trackAliRtcVideoTrack视频流类型。
    subboolean停止或恢复特定远端用户的视频流拉取,取值:
    • true(默认值):恢复。
    • false:停止。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • createRenderSurfaceView:创建SurfaceView渲染视图。
    public abstract SophonSurfaceView createRenderSurfaceView(Context context);
    参数说明
    参数类型描述
    contextContext安卓(Android Activity)的上下文。
  • createRenderTextureView:创建TextureView渲染视图。
    public abstract SophonTextureView createRenderTextureView(Context context);
    参数说明
    参数类型描述
    contextContext安卓(Android Activity)的上下文。
  • setScreenShareEncoderConfiguration:设置屏幕共享编码属性。
    public abstract void setScreenShareEncoderConfiguration(AliRtcScreenShareEncoderConfiguration config);
    参数说明
    参数类型描述
    configAliRtcScreenShareEncoderConfiguration屏幕共享编码属性。默认值:
    • dimensions:[0,0]
    • frameRate:5
    • bitrate:0
    • rotation:0
  • setLocalViewConfig:为本地预览设置渲染窗口以及绘制参数。
    public abstract int setLocalViewConfig(AliVideoCanvas viewConfig, AliRtcVideoTrack track);

    支持加入频道之前和之后切换窗口。如果AliVideoCanvas或者AliVideoCanvas中的view参数为空,则停止渲染。

    如果在播放过程中需要重新设置AliVideoCanvas的参数renderMode,请保持其他参数不变,仅修改renderMode。

    如果在播放过程中需要重新设置AliVideoCanvas的参数mirrorMode,请保持其他参数不变,仅修改mirrorMode。

    参数说明
    参数类型描述
    viewConfigAliVideoCanvas渲染参数,包含渲染窗口以及渲染方式。
    trackAliRtcVideoTrack视频流类型。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setCameraCapturerConfiguration:设置摄像头采集偏好。
    public abstract int setCameraCapturerConfiguration(AliEngineCameraCapturerConfiguration cameraCapturerConfiguration);
    参数说明
    参数类型描述
    cameraCapturerConfigurationAliEngineCameraCapturerConfiguration摄像头采集偏好。默认值:
    • preference:0
    • cameraDirection:0
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • enableLocalVideo:禁用或重新启用本地视频采集。
    public abstract int enableLocalVideo(boolean enable);
    参数说明
    参数类型描述
    enableboolean禁用或重新启用本地视频采集,取值:
    • true(默认值):重新启用。
    • false:禁用。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • muteLocalCamera:停止或恢复本地视频数据发送。
    public abstract int muteLocalCamera(boolean mute, AliRtcVideoTrack track);
    参数说明
    参数类型描述
    muteboolean停止或恢复本地视频数据发送,取值:
    • true:停止。
    • false(默认值):恢复。
    trackAliRtcVideoTrack需要改变发布状态的视频流类型。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

    重要 此接口只是控制指定视频流上是否发送黑帧,采集和数据发送不会停止。如果需要关闭采集请使用enableLocalVideo接口,如果需要中止视频数据发送请使用publishLocalVideoStream接口。
  • muteAllRemoteVideoRendering:停止或恢复远端所有的视频渲染。
    public abstract int muteAllRemoteVideoRendering(boolean mute);

    拉流和解码不受影响。支持加入频道之前和之后设置。

    参数说明
    参数类型描述
    muteboolean停止或恢复远端所有的视频渲染,取值:
    • true:停止渲染,所有视频为黑帧。
    • false(默认值):表示恢复渲染。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setRemoteViewConfig:为远端的视频设置渲染窗口以及绘制参数。
    public abstract int setRemoteViewConfig(AliVideoCanvas canvas, String uid,AliRtcVideoTrack track);

    支持加入频道之前和之后切换窗口。如果AliVideoCanvas或者AliVideoCanvas中的view参数为空,则停止渲染。

    如果在播放过程中需要重新设置AliVideoCanvas的参数renderMode,请保持其他参数不变,仅修改renderMode。

    如果在播放过程中需要重新设置AliVideoCanvas的参数mirrorMode,请保持其他参数不变,仅修改mirrorMode。

    参数说明
    参数类型描述
    canvasAliVideoCanvas渲染参数,包含渲染窗口以及渲染方式。
    uidString用户ID。
    trackAliRtcVideoTrack需要设置的视频流类型。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • isCameraOn:检查摄像头是否打开。
    public abstract boolean isCameraOn();
    返回说明

    true表示摄像头已打开,false表示摄像头未打开。

  • stopRecord:停止录制。
    public abstract void stopRecord();
  • startRecord:开始录制(非布局录制)。
    public abstract boolean startRecord(AliRtcRecordType recordType,AliRtcRecordFormat recordFormat,
                                        String filePath,AliRtcRecordAudioConfig audioConfig, 
                                        AliRtcRecordVideoConfig videoConfig);
    参数说明
    参数类型描述
    recordTypeAliRtcRecordType录制类型。
    recordFormatAliRtcRecordFormat录制格式。
    filePathString文件路径。
    audioConfigAliRtcRecordAudioConfig录制音频文件参数配置。
    videoConfigAliRtcRecordVideoConfig录制视频文件参数配置(移动端不支持录制视频)。
    返回说明

    true表示方法调用成功,false方法调用失败。

  • setBeautyEffect:设置是否启用基础美颜。
    public abstract int setBeautyEffect(boolean enable, AliRtcBeautyConfig config);
    参数说明
    参数类型描述
    enableboolean是否启用基础美颜,取值:
    • true:开启美颜。
    • false:关闭美颜。
    默认false。
    configAliRtcBeautyConfig基础美颜参数。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

    说明 此接口目前只支持美白和磨皮。
  • setVideoEncoderConfiguration:设置视频编码属性。
    public abstract void setVideoEncoderConfiguration(AliRtcVideoEncoderConfiguration config);
    参数说明
    参数类型描述
    configAliRtcVideoEncoderConfiguration预定义的编码属性。默认值:
    • dimensions:[640,480]
    • frameRate:15
    • bitrate:0
    • mirrorMode:0
    • orientationMode:0
    • rotation:0
  • addVideoWatermark:添加水印。
    public abstract int addVideoWatermark(AliRtcVideoTrack track, String imageUrl, AliRtcWatermarkConfig config);
    参数说明
    参数类型描述
    trackAliRtcVideoTrack数据流类型。
    imageUrlString水印图片路径。
    configAliRtcWatermarkConfig水印配置。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • clearVideoWatermark:清理对应数据流水印信息。
    public abstract int clearVideoWatermark(AliRtcVideoTrack track);
    参数说明
    参数类型描述
    trackAliRtcVideoTrack数据流类型。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • snapshotVideo:截图。
    public abstract int snapshotVideo(String userId, AliRtcVideoTrack trackType);
    参数说明
    参数类型描述
    userIdString用户ID,为空表示本地用户。
    trackTypeAliRtcVideoTrack流类型。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。截图结果通过onSnapshotComplete回调返回。

  • switchCamera:切换前后摄像头(默认为前置摄像头)。
    public abstract int switchCamera();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • getCurrentCameraDirection:获取当前摄像头方向。
    public abstract AliRTCCameraDirection getCurrentCameraDirection();
    返回说明
    • 返回CAMERA_REAR(0)表示后置摄像头。
    • 返回CAMERA_FRONT(1)表示前置摄像头。
    • 返回CAMERA_INVALID(-1)表示无效。
    说明 此接口需要在摄像头打开之后调用,否则会返回CAMERA_INVALID(-1)。
  • setCameraZoom:设置摄像头缩放比例。
    public abstract int setCameraZoom(float zoom);
    参数说明
    参数类型描述
    zoomfloatzoom的级别。默认值为1.0。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setCameraFlash:设置摄像头闪光灯是否打开。
    public abstract int setCameraFlash(boolean flash);
    参数说明
    参数类型描述
    flashboolean摄像头闪光灯是否打开,取值:
    • true:开启。
    • false(默认值):关闭。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setCameraFocusPoint:设置摄像头手动聚焦。
    public abstract int setCameraFocusPoint(float pointX, float pointY);
    参数说明
    参数类型描述
    pointXfloat聚焦点X坐标。
    pointYfloat聚焦点Y坐标。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setCameraExposurePoint:设置摄像头曝光点。
    public abstract int setCameraExposurePoint(float pointX, float pointY);
    参数说明
    参数类型描述
    pointXfloat聚焦点X坐标。
    pointYfloat聚焦点Y坐标。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • isCameraAutoFocusFaceModeSupported:摄像头是否支持人脸聚焦。
    public abstract boolean isCameraAutoFocusFaceModeSupported();
    返回说明

    true表示支持,false表示不支持。

  • setCameraAutoFocusFaceModeEnabled:设置摄像头人脸对焦。
    public abstract boolean setCameraAutoFocusFaceModeEnabled(boolean enable);
    参数说明
    参数类型描述
    enableboolean是否开启摄像头人脸对焦,取值:
    • true:开启。
    • false(默认值):关闭。
    返回说明

    true表示方法调用成功,false方法调用失败。

  • startScreenShare:开始屏幕分享。
    public abstract int startScreenShare();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • startScreenShare:开始屏幕分享。
    public abstract int startScreenShare(Intent intent);

    可以在外部创建并启动屏幕分享。

    参数说明
    参数类型描述
    intentIntent外部创建并启动屏幕分享。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopScreenShare:停止屏幕分享。
    public abstract int stopScreenShare();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAudioOnlyMode:设置音频模式还是音视频模式。
    public abstract int setAudioOnlyMode(boolean audioOnly);
    参数说明
    参数类型描述
    audioOnlyboolean设置音频模式还是音视频模式,取值:
    • true:只有音频推流和拉流。
    • false(默认值):音视频都支持。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • isAudioOnly:检查当前是否纯音频模式。
    public abstract boolean isAudioOnly();
    参数说明

    true纯音频模式,false音视频模式。

  • muteLocalMic:停止或恢复本地音频数据发送。
    public abstract int muteLocalMic(boolean mute, AliRtcMuteLocalAudioMode mode);
    参数说明
    参数类型描述
    muteboolean停止或恢复本地音频数据发送,取值:
    • true:本地音频发送静音帧。
    • false(默认值):恢复。
    modeAliRtcMuteLocalAudioMode静音模式,默认麦克风静音模式。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。mute只是发送音频数据为静音帧,采集和编码模块仍然在工作。

  • muteRemoteAudioPlaying:停止或恢复远端的音频播放。
    public abstract int muteRemoteAudioPlaying(String uid, boolean mute);
    参数说明
    参数类型描述
    uidString用户ID。
    muteboolean停止或恢复远端的音频播放,取值:
    • true:停止播放。
    • false(默认值):恢复播放。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • muteAllRemoteAudioPlaying:停止或恢复远端所有的音频播放。
    public abstract int muteAllRemoteAudioPlaying(boolean mute);
    参数说明
    参数类型描述
    muteboolean停止或恢复远端所有的音频播放,取值:
    • true:停止播放。
    • false(默认值):恢复播放。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • startAudioCapture:开启音频采集。
    public abstract int startAudioCapture();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • startAudioCapture:开启音频采集。
    public abstract int startAudioCapture(boolean keepAlive);
    参数说明
    参数类型描述
    keepAliveboolean离会后采集设备的状态,取值:
    • true:离会后采集设备保持开启状态。
    • false(默认值):离会后采集设备关闭。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopAudioCapture:关闭音频采集。
    public abstract int stopAudioCapture();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • startAudioPlayer:开启音频播放设备。
    public abstract int startAudioPlayer();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopAudioPlayer:关闭音频播放。
    public abstract int stopAudioPlayer();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setRemoteAudioVolume:设置本地播放的指定远端用户音量。
    public abstract int setRemoteAudioVolume(String uid, int volume);
    参数说明
    参数类型描述
    uidString用户ID。
    intvolume播放音量,取值范围:[0,100]。0表示静音,100表示原始音量,默认值为100。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • enableSpeakerphone:设置音频输出为听筒还是扬声器。
    public abstract int enableSpeakerphone(boolean enable);
    参数说明
    参数类型描述
    enableboolean音频输出为听筒还是扬声器,取值:
    • true(默认值):扬声器模式。
    • false:听筒模式。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • isSpeakerOn:获取当前音频输出为听筒还是扬声器。
    public abstract boolean isSpeakerOn();
    返回说明

    true为扬声器,false为听筒。

  • setRecordingVolume:设置录音音量。
    public abstract int setRecordingVolume(int volume);
    参数说明
    参数类型描述
    volumeint音量取值范围:[0,400]。0表示静音,100表示原始音量。大于100表示放大音量,小于100表示减小音量,默认值为100。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setPlayoutVolume:设置播放音量。
    public abstract int setPlayoutVolume(int volume);
    参数说明
    参数类型描述
    volumeint音量取值范围:[0,400]。0表示静音,100表示原始音量。大于100表示放大音量,小于100表示减小音量,默认值为100。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • enableAudioVolumeIndication:设置音量回调频率和平滑系数。
    public abstract int enableAudioVolumeIndication(int interval, int smooth, int reportVad);
    参数说明
    参数类型描述
    intervalint时间间隔。
    • 单位:ms。
    • 默认值:300ms。
    • 取值范围:最小值≥10ms,建议设置为300ms~500ms;取值≤0表示不启用音量提示和说话人提示功能。
    smoothint平滑系数,数值越大平滑程度越高,反之越低,实时性越好。
    • 默认值:3。
    • 取值范围:0~9,建议设置为3。
    reportVadint本地语音检测开关。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAudioProfile:设置音频Profile。
    public abstract int setAudioProfile(AliRtcAudioProfile profile, AliRtcAudioScenario scenario);
    参数说明
    参数类型描述
    profileint音频采集或编码模式参数,默认值为AliEngineBasicQualityMode。更多信息,请参见AliRtcAudioProfile
    scenarioint音频场景模式参数,默认值为AliEngineSceneDefaultMode。更多信息,请参见AliRtcAudioScenario
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • enableAudioDTX:开启本地音频流量控制(语音)。
    public abstract int enableAudioDTX(boolean enable);
    参数说明
    参数类型描述
    enableboolean开启本地音频流量控制,取值:
    • true:开启。
    • false(默认值):关闭。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。推流之前调用有效。开启语音活动检测可以在检测到没有语音的情况下,发送字节数减少,节省用户流量。

  • enableAudioAMD:开启本地音频流量控制(麦克风)。
    public abstract int enableAudioAMD(boolean enable);
    参数说明
    参数类型描述
    enableboolean开启本地音频流量控制,取值:
    • true:开启。
    • false(默认值):关闭。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。推流之前调用有效。开启语音活动检测可以在检测到麦克风静音或者关闭麦克风时停止发送音频包。

  • setAudioEffectVoiceChangerMode:设置变声音效模式。
    public abstract int setAudioEffectVoiceChangerMode(AliRtcAudioEffectVoiceChangerMode mode);
    参数说明
    参数类型描述
    modeAliRtcAudioEffectVoiceChangerMode变声音效模式,默认值为AliRtcSdk_AudioEffect_Voice_Changer_OFF(关闭)。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAudioEffectPitchValue:设置变调参数。
    public abstract int setAudioEffectPitchValue(double value);
    参数说明
    参数类型描述
    valuedouble参数取值范围:[0.5,2.0],默认值为1.0,表示音调不变。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAudioEffectReverbMode:设置混响音效模式。
    public abstract int setAudioEffectReverbMode(AliRtcAudioEffectReverbMode mode);
    参数说明
    参数类型描述
    modeAliRtcAudioEffectReverbMode音效混响模式,默认值为AliRtcAudioEffectReverb_Off(关闭)。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAudioEffectReverbParamType:设置混响音效类型和具体参数。
    public abstract int setAudioEffectReverbParamType(AliRtcAudioEffectReverbParamType type, float value);
    参数说明
    参数类型描述
    typeAliRtcAudioEffectReverbParamType音效混响参数。
    valuefloat具体参数值。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • startAudioAccompany:开始混音。
    public abstract int startAudioAccompany(String fileName, boolean onlyLocalPlay, boolean replaceMic, int loopCycles);
    参数说明
    参数类型描述
    filePathString混音文件路径。
    onlyLocalPlayboolean是否仅本地播放,取值:
    • true:仅本地播放。
    • false:本地播放且推流到远端。
    replaceMicboolean是否替换mic的音频流,取值:
    • true:伴奏音频流替换本地mic音频流。
    • false:伴奏音频流和mic音频流同时推。
    loopCyclesint循环次数,-1表示一直循环。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopAudioAccompany:停止混音。
    public abstract int stopAudioAccompany();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAudioAccompanyVolume:设置混音音量。
    public abstract int setAudioAccompanyVolume(int volume);
    参数说明
    参数类型描述
    volumeint混音音量,取值范围:0~100,默认值为50。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。设置音量需要在startAudioAccompany后才能生效。

  • setAudioAccompanyPublishVolume:设置混音之后推流出去的音量(Android和iOS)。
    public abstract int setAudioAccompanyPublishVolume(int volume);
    参数说明
    参数类型描述
    volumeint混音音量,取值范围:0~100,默认值为50。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。设置音量需要在startAudioAccompany后才能生效。

  • getAudioAccompanyPublishVolume:获取推流出去的混音音量。
    public abstract int getAudioAccompanyPublishVolume();
    返回说明

    返回推流出的混音音量。

  • setAudioAccompanyPlayoutVolume:设置混音之后本地播放的音量(Android和iOS)。
    public abstract int setAudioAccompanyPlayoutVolume(int volume);
    参数说明
    参数类型描述
    volumeint混音音量,取值范围:0~100,默认值为50。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。设置音量需要在startAudioAccompany后才能生效。

  • getAudioAccompanyPlayoutVolume:获取混音本地播放的音量。
    public abstract int getAudioAccompanyPlayoutVolume();
    返回说明

    当前混音本地播放的音量大小。

  • pauseAudioAccompany:暂停混音。
    public abstract int pauseAudioAccompany();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • resumeAudioAccompany:重新开始混音。
    public abstract int resumeAudioAccompany();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • getAudioAccompanyDuration:获取伴奏文件时长。
    public abstract int getAudioAccompanyDuration();
    返回说明

    当前伴奏文件时长,单位为毫秒。

  • getAudioAccompanyCurrentPosition:获取音乐文件播放进度。
    public abstract int getAudioAccompanyCurrentPosition();
    返回说明

    当前音乐文件播放进度,单位为毫秒。

  • setAudioAccompanyPosition:设置音频文件的播放位置。
    public abstract int setAudioAccompanyPosition(int posMs);
    参数说明
    参数类型描述
    posMsint进度条位置,单位:毫秒。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • preloadAudioEffect:预加载音效文件。
    public abstract int preloadAudioEffect(int soundId, String filePath);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    filePathString音效文件路径。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • unloadAudioEffect:删除预加载的音效文件。
    public abstract int unloadAudioEffect(int soundId);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • playAudioEffect:开始播放音效。
    public abstract int playAudioEffect(int soundId, String filePath, int cycles, boolean publish);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    filePathString音效文件路径。
    cyclesint循环次数,-1表示一直循环。
    publishboolean是否将音效音频流推到远端,取值:
    • true:将音效音频流推到远端。
    • false(默认值):不将音效音频流推到远端。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopAudioEffect:停止播放音效。
    public abstract int stopAudioEffect(int soundId);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopAllAudioEffects:停止播放所有音效。
    public abstract int stopAllAudioEffects();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAudioEffectPublishVolume:设置音效推流音量。
    public abstract int setAudioEffectPublishVolume(int soundId, int volume);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    volumeint混音音量,取值范围:0~100,默认值为50。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • getAudioEffectPublishVolume:获取推流音效音量。
    public abstract int getAudioEffectPublishVolume(int soundId);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAudioEffectPlayoutVolume:设置音效本地播放音量。
    public abstract int setAudioEffectPlayoutVolume(int soundId, int volume);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    volumeint混音音量,取值范围:0~100,默认值为50。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • getAudioEffectPlayoutVolume:获取音效本地播放音量(Android和iOS)。
    public abstract int getAudioEffectPlayoutVolume(int soundId);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAllAudioEffectsPublishVolume:设置所有音效推流混音音量。
    public abstract int setAllAudioEffectsPublishVolume(int volume);
    参数说明
    参数类型描述
    volumeint混音音量,取值范围:0~100,默认值为50。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setAllAudioEffectsPlayoutVolume:设置所有音效本地播音量(Android和iOS)。
    public abstract int setAllAudioEffectsPlayoutVolume(int volume);
    参数说明
    参数类型描述
    volumeint混音音量,取值范围:0~100,默认值为50。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • pauseAudioEffect:暂停音效。
    public abstract int pauseAudioEffect(int soundId);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • pauseAllAudioEffects:暂停所有音效。
    public abstract int pauseAllAudioEffects();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • resumeAudioEffect:重新开始播放音效。
    public abstract int resumeAudioEffect(int soundId);
    参数说明
    参数类型描述
    soundIdint用户给该音效文件分配的ID。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • resumeAllAudioEffects:重新开始播放所有音效。
    public abstract int resumeAllAudioEffects();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • enableEarBack:启用耳返。
    public abstract int enableEarBack(boolean enable);
    参数说明
    参数类型描述
    enableboolean是否启用耳返,取值:
    • true:开启耳返。
    • false(默认值):关闭耳返。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setEarBackVolume:设置耳返音量。
    public abstract int setEarBackVolume(int volume);
    参数说明
    参数类型描述
    volumeint音量,取值范围:0~100。默认值为100。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • requestAudioFocus:请求音频焦点。
    public abstract int requestAudioFocus();
  • abandonAudioFocus:丢失音频焦点。
    public abstract int abandonAudioFocus();
  • registerVideoSampleObserver:注册视频数据输出对象。
    public abstract void registerVideoSampleObserver(AliVideoObserver observer);
    参数说明
    参数类型描述
    observerAliVideoObserver视频数据输出对象。
    返回说明

    输出数据将通过AliVideoObserver回调返回。

  • unRegisterVideoSampleObserver:取消注册视频数据输出对象。
    public abstract void unRegisterVideoSampleObserver();
  • registerLocalVideoTextureObserver:注册本地相机流视频OpenGL纹理数据观测器。
    public abstract void registerLocalVideoTextureObserver(AliTextureObserver observer);
    参数说明
    参数类型描述
    observerAliTextureObserverOpenGL纹理数据观测器。
    返回说明

    输出数据将通过AliVideoObserver回调返回。

  • unRegisterLocalVideoTextureObserver:取消注册本地相机流视频OpenGL纹理数据观测器。
    public abstract void  unRegisterLocalVideoTextureObserver();
  • registerAudioObserver:订阅音频数据输出。
    public abstract void registerAudioObserver(AliAudioType type, AliAudioObserver observer);
    参数说明
    参数类型描述
    typeAliAudioType数据类型。
    observerAliVideoObserver音频数据接收对象。
  • unRegisterAudioObserver:取消音频数据输出。
    public abstract void unRegisterAudioObserver(AliAudioType type);
    参数说明
    参数类型描述
    typeAliAudioType数据类型。
  • setSubscribeAudioNumChannel:设置输出音频声道数,默认单声道(混音前数据不支持该参数设置)。
    public abstract void setSubscribeAudioNumChannel(AliRtcAudioNumChannel numChannel);
    参数说明
    参数类型描述
    numChannelAliRtcAudioNumChannel声道数。
  • setSubscribeAudioSampleRate:设置输出音频采样率,默认44.1k(混音前数据不支持该参数设置)。
    public abstract void setSubscribeAudioSampleRate(AliRtcAudioSampleRate sampleRate );
    参数说明
    参数类型描述
    sampleRateAliRtcAudioSampleRate采样率。
  • registerAudioVolumeObserver:注册音量数据输出对象。
    public abstract void registerAudioVolumeObserver(AliRtcAudioVolumeObserver observer);
    参数说明
    参数类型描述
    observerAliRtcAudioVolumeObserver音量数据接收对象。
  • unRegisterAudioVolumeObserver:取消注册音量数据输出对象。
    public abstract void unRegisterAudioVolumeObserver();
  • setExternalVideoSource:启用外部视频输入源。
    public abstract void setExternalVideoSource(boolean enable,boolean useTexture,
                                                AliRtcVideoTrack streamType,AliRtcRenderMode renderMode);
    参数说明
    参数类型描述
    enableboolean启用外部视频输入源,取值:
    • true:启用。
    • false(默认值):关闭。
    useTextureboolean是否使用texture模式,取值:
    • true:使用。
    • false(默认值):不使用。
    typeAliRtcVideoTrack视频流类型。
    renderModeAliRtcRenderMode渲染模式。
  • pushExternalVideoFrame:输入视频数据。
    public abstract int pushExternalVideoFrame(AliRtcRawDataFrame aliRawDataFrame,AliRtcVideoTrack streameType);
    参数说明
    参数类型描述
    aliRawDataFrameAliRtcRawDataFrame帧数据。
    streameTypeAliRtcVideoTrack视频流类型。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setExternalAudioSource:设置是否启用外部音频输入源。
    public abstract  int setExternalAudioSource(boolean enable ,int sampleRate,int channels);
    参数说明
    参数类型描述
    enableboolean是否启用外部音频输入源。
    • true:开启。
    • false(默认值):关闭。
    sampleRateint采样率。
    channelsPerFrameint声道数,取值1或2。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • pushExternalAudioFrameRawData:输入音频数据。
    public abstract  int pushExternalAudioFrameRawData(byte[] samples,int samplesLength,long timestamp);
    参数说明
    参数类型描述
    samplesbyte[]音频数据,不建议超过40毫秒。
    samplesLengthint采样。
    timestampdouble时间戳。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setExternalAudioVolume:设置外部音频音量。
    public abstract  int setExternalAudioVolume(int vol);
    参数说明
    参数类型描述
    volint音量,取值范围:0~100,默认值为50。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • getExternalAudioVolume:获取混音音量。
    public abstract  int getExternalAudioVolume();
    返回说明

    返回当前混音音量。

  • setMixedWithMic:设置外部音频输入是否与麦克风采集音频混合。
    public abstract int setMixedWithMic(boolean mixed);
    参数说明
    参数类型描述
    mixedboolean是否与麦克风采集音频混合,取值:
    • true(默认值):混合。
    • false:完全替换麦克风采集数据。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • setExteranlAudioRender:设置是否启用外部输入音频播放。
    public abstract int setExteranlAudioRender(boolean enable,int sampleRate,int channelsPerFrame);
    参数说明
    参数类型描述
    enableboolean是否启用外部输入音频播放,取值:
    • true:开启。
    • false(默认值):关闭。
    sampleRateint采样率。
    channelsPerFrameint声道数,取值1或2。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • pushExternalAudioRenderRawData:输入外部音频播放数据。
    public abstract int pushExternalAudioRenderRawData(byte[]audioSamples ,int sampleLength,int sampleRate,
                                                       int channelsPerFrame, long timestamp);
    参数说明
    参数类型描述
    audioSamplesbyte[]音频数据。
    sampleLengthint音频数据长度。
    sampleRateint音频采样率。
    channelsPerFrameint音频声道数。
    timestamplong时间戳。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • startPublishLiveStream:开启旁路直播。
    public abstract int startPublishLiveStream(String streamUrl,AliRtcLiveTranscodingParam transcodingParam);
    参数说明
    参数类型描述
    streamUrlString推流地址。
    transcodingParamAliRtcLiveTranscodingParam推流参数。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • updatePublishLiveStream:更新旁路直播相关参数。
    public abstract int updatePublishLiveStream(String streamUrl,AliRtcLiveTranscodingParam transcodingParam);
    参数说明
    参数类型描述
    streamUrlString推流地址。
    transcodingParamAliRtcLiveTranscodingParam推流参数。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopPublishLiveStream:停止旁路直播。
    public abstract int stopPublishLiveStream(String streamUrl);
    参数说明
    参数类型描述
    streamUrlString推流地址。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • startChannelRelay:开启跨频道连麦。
    public abstract int startChannelRelay(AliRtcChannelRelayConfiguration configuration);
    参数说明
    参数类型描述
    configurationAliRtcChannelRelayConfiguration配置信息。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • updateChannelRelay:更新跨频道连麦。
    public abstract int updateChannelRelay(AliRtcChannelRelayConfiguration configuration);
    参数说明
    参数类型描述
    configurationAliRtcChannelRelayConfiguration配置信息。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopChannelRelay:停止跨频道连麦。
    public abstract int stopChannelRelay();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • startPreview:开始本地预览。
    public abstract int startPreview();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • stopPreview:停止本地预览。
    public abstract int stopPreview();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • getOnlineRemoteUsers:获取远端在线用户列表。
    public abstract String[] getOnlineRemoteUsers();
    返回说明

    返回String[]表示用户列表,保存的是用户ID。

  • getUserInfo:查询远端用户的各种状态。
    public abstract AliRtcRemoteUserInfo getUserInfo(String uid);
    参数说明
    参数类型描述
    uidString远端用户ID。从App server分配的唯一标示符。
    返回说明

    返回一个远端用户对象AliRtcRemoteUserInfo

  • isUserOnline:判断用户是否在线。
    public abstract boolean isUserOnline(String uid);
    参数说明
    参数类型描述
    uidString用户ID。从App server分配的唯一标示符。
    返回说明

    true为在线,false为未在线。

  • setLogDirPath:设置SDK日志文件保存路径。
    public static int setLogDirPath(String logDirPath);
    参数说明
    参数类型描述
    logDirPathString日志文件保存绝对路径。默认路径:/sdcard/Ali_RTC_Log目录下。
    返回说明
    0表示方法调用成功,非0表示方法调用失败。
    说明 如需调用此接口,请在调用所有SDK接口前进行设置,避免日志丢失,同时App必须保证指定的路径已存在并且可写入。
  • setLogLevel:设置日志等级。
    public static void setLogLevel(AliRtcLogLevel logLevel);
    参数说明
    参数类型描述
    logLevelAliRtcLogLevelLog级别。
  • getSdkVersion:获取SDK版本号。
    public static String getSdkVersion();
    返回说明

    返回SDK版本号。

  • getErrorDescription:获取错误码描述。
    public static String getErrorDescription(int errorCode);
    参数说明
    参数类型描述
    errorCodeint错误码。
    返回说明

    返回错误码描述字符串。

  • setClientRole:设置用户角色。
    public abstract int setClientRole(AliRTCSdkClientRole clientRole);
    参数说明
    参数类型描述
    clientRoleAliRTCSdkClientRole用户角色类型,默认值为AliRTCSdkLive(观众角色),非通信模式下角色类型才有效。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • getCurrentClientRole:获取用户角色。
    public abstract AliRTCSdkClientRole getCurrentClientRole();
    返回说明

    返回当前用户角色。

  • startNetworkQualityProbeTest:开始网络质量探测。
    public abstract int startNetworkQualityProbeTest();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。请在进入频道之前调用,探测结果通过onNetworkQualityProbeTest回调返回。

  • stopNetworkQualityProbeTest:停止网络质量探测。
    public abstract int stopNetworkQualityProbeTest();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • respondMessageNotification:发送下行通道消息。
    public abstract int respondMessageNotification(String tid, String contentType, String content);
    参数说明
    参数类型描述
    tidString信令ID。
    contentTypeString消息类型
    contentString消息内容。
  • uplinkChannelMessage:发送上行通道消息。
    public abstract int uplinkChannelMessage(String contentType, String content);

    SaaS客户端发送信令消息到SaaS服务端。

    参数说明
    参数类型描述
    contentTypeString信令类型
    contentString信令内容。
  • postFeedback:问题反馈。
    public abstract void postFeedback(String uid,String channelId,String description,AliRtcFeedbackType type,long timeStamp);
    参数说明
    参数类型描述
    uidString当前用户ID(可为空)。
    channelIdString当前频道ID(可为空)。
    descriptionString问题描述(支持中英文,不为空)。
    typeAliRtcFeedbackType问题类型。
    timeStamplong问题发生的时间戳(Unix时间戳,大致时间,无需特别精确,可以为0)。
  • sendMediaExtensionMsg:发送媒体扩展信息。
    public abstract int sendMediaExtensionMsg(byte[]message, int repeatCount);
    参数说明
    参数类型描述
    messagebyte[]扩展信息。
    repeatCountint重复次数。
    返回说明
    • 0:成功。
    • -1:未推流。
    • -2:参数错误。
    • -3:过于频繁。
  • startIntelligentDenoise:开启智能降噪。
    public abstract int startIntelligentDenoise();
    返回说明

    0表示方法调用成功,其他表示方法调用失败。此接口可以通话过程中控制打开智能降噪功能。

  • stopIntelligentDenoise:关闭智能降噪。
    public abstract void stopIntelligentDenoise();
  • refreshAuthInfo:刷新鉴权信息。
    public abstract int refreshAuthInfo(AliRtcAuthInfo authInfo);
    参数说明
    参数类型描述
    authInfoAliRtcAuthInfo鉴权信息。
    返回说明

    0表示方法调用成功,其他表示方法调用失败。

  • getCurrentConnectionStatus:获取当前网络链接状态。
    public abstract AliRtcConnectionStatus getCurrentConnectionStatus();
    返回说明

    返回当前网络链接状态,状态详情请参见AliRtcConnectionStatus

  • getVideoCaptureData:主动获取采集数据。
    public abstract boolean getVideoCaptureData(AliRtcEngine.AliRtcVideoTrack track, AliRtcEngine.AliRtcVideoSample videoSample);
    参数说明
    参数类型说明
    trackAliRtcVideoTrack视频流类型。
    videoSampleAliRtcVideoSample视频样本。
    返回说明

    true表示方法调用成功,false表示方法调用失败。

  • getVideoPreEncoderData:主动获取编码前数据。
    public abstract boolean getVideoPreEncoderData(AliRtcEngine.AliRtcVideoTrack track, AliRtcEngine.AliRtcVideoSample videoSample);
    参数说明
    参数类型说明
    trackAliRtcVideoTrack视频流类型。
    videoSampleAliRtcVideoSample视频样本。
    返回说明

    true表示方法调用成功,false表示方法调用失败。

  • getVideoRenderData:主动获取拉流数据。
    public abstract boolean getVideoRenderData(String userId, AliRtcEngine.AliRtcVideoTrack track, AliRtcEngine.AliRtcVideoSample videoSample);
    参数说明
    参数类型说明
    userIdString远端用户ID。
    trackAliRtcVideoTrack视频流类型。
    videoSampleAliRtcVideoSample视频样本。
    返回说明

    true表示方法调用成功,false表示方法调用失败。

  • getPublishLiveStreamState:获取旁路直播状态。
    public abstract AliRtcEngine.AliRtcLiveTranscodingState getPublishLiveStreamState(String streamUrl);
    参数说明
    参数类型说明
    streamUrlString旁路直播推流地址。
    返回说明

    返回旁路直播状态。

  • showDebugView:显示仪表盘。
    public abstract void showDebugView(ViewGroup viewGroup, int showType, String userId);
    参数说明
    参数类型说明
    viewGroupViewGroupView,由业务侧来负责布局。
    showTypeint显示类型,取值:
    • 0(默认值):不显示。
    • 1:音频。
    • 2:视频。
    • 3: 网络。
    • 4: 全部。
    说明 对于不公开的数据,可以设置特殊值。
    userIdString指定用户的相关数据。