通过阅读本文,您可以了解实时音视频Harmony SDK接口详情。
目录
基础接口
API | 功能描述 |
获取 AliRtcEngine 实例 | |
销毁 AliRtcEngine 实例 | |
查询sdk当前版本号 | |
设置H5兼容模式 | |
获取H5兼容模式设置 | |
设置自身相关监听事件回调 | |
获取Native层实例句柄 |
频道相关接口
API | 功能描述 |
设置频道模式 | |
设置直播场景 AliRtcClientRole 设置为 对应的用户角色 | |
获取当前用户角色 | |
该方法让用户加入频道,一个频道内可以加入多个用户进行互相通话 | |
加入频道 | |
加入频道 | |
加入AI频道 | |
离开频道,即挂断或者停止童话 | |
获取当前网络链接状态 | |
获取状态:当前是否在频道中 | |
刷新鉴权信息 | |
刷新鉴权信息 | |
查询是否纯音频模式 |
发布及订阅相关接口
API | 功能描述 |
是否推送本地视频(摄像头)流 | |
查询是否设置推送视频流 | |
是否推送次要视频流 | |
查询当前是否设置推送次要视频流 | |
是否推送本地音频流 | |
查询是否设置推送音频流 | |
是否推送次要音频流 | |
查询是否设置推送第二条音频流 | |
设置是否默认接收音频流 | |
设置是否默认订阅视频流 | |
设置订阅的相机流格式,大流或小流 | |
设置默认订阅的相机流格式,大流或小流 | |
停止/恢复接收所有远端音频流 | |
停止/恢复接收远端第二条音频流 | |
停止/恢复接收所有远端视频流 | |
停止/恢复订阅麦克风音频流 | |
停止/恢复订阅特定远端用户的音频流 | |
停止/恢复订阅视频流 | |
停止/恢复订阅远端音视频流 | |
订阅目标频道,指定用户的流 |
音频设备管理相关接口
API | 功能描述 |
设置音频profile | |
设置音频能力 | |
开启音频采集 | |
开启音频采集 | |
开启音频播放设备 | |
关闭音频播放 | |
停止/恢复本地音频数据发送 | |
设置录音音量 | |
设置播放音量 | |
设置默认音频输出是否从扬声器出声,默认从扬声器出声 | |
设置音频输出为听筒还是扬声器 | |
获取当前音频输出为听筒还是扬声器 | |
调节本地播放的指定远端用户音量 | |
停止/恢复远端指定用户的音频流的播放 | |
停止/恢复远端的所有音频流的播放 | |
设置音量回调频率和平滑系数 | |
启用耳返 | |
设置耳返音量 | |
通话前,开启音频采集设备检测 | |
关闭音频采集检测 | |
测试播放音频文件 | |
停止测试播放音频文件 |
视频设备管理相关接口
API | 功能描述 |
设置本地预览显示视图 | |
开启本地视频预览 | |
关闭本地视频预览 | |
设置摄像头采集偏好 | |
禁用或启用本地视频采集 | |
停止/恢复本地摄像头采集 | |
停止/恢复本地视频数据发送 | |
检查当前是否打开摄像头 | |
停止/恢复远端所有视频track渲染 | |
设置相机流视频编码属性 | |
设置相机流视频解码属性 | |
设置预览和推流镜像能力 | |
设置采集缩放时机,视频数据是采集的时候立即缩放还是编码时才进行缩放 | |
设置远端视频显示视图 | |
切换前后摄像头 | |
获取当前摄像头方向(前/后摄像头) | |
设置摄像头缩放比例 | |
获取摄像头最大缩放比例 | |
获取摄像头缩放比例 | |
设置摄像头曝光度 | |
获取摄像头曝光度 | |
获取摄像头最小曝光度 | |
获取摄像头最大曝光度 | |
设置摄像头闪光灯是否打开 | |
摄像头是否支持手动聚焦 | |
摄像头是否支持设置曝光区域 | |
设置摄像头手动聚焦 | |
设置摄像头曝光点 | |
获取视频编解码格式 | |
获取当前使用的编码器类型,如未开始推流,返回无效类型 | |
视频截图功能 |
桌面共享
API | 功能描述 |
设置屏幕流视频编码属性 | |
开启屏幕帧监听 | |
停止屏幕共享 | |
查询是否设置推送屏幕分享 |
配置音频数据回调
API | 功能描述 |
注册音频数据回调 | |
订阅音频数据 |
自定义音频输入
API | 功能描述 |
新增外部音频流 | |
输入外部音频数据 | |
设置外部音频流播放音量 | |
获取外部音频流播放音量 | |
设置外部音频流推流音量 | |
获取外部音频流推流音量 | |
移除外部音频流 |
自定义视频输入
API | 功能描述 |
启用外部视频输入源 | |
输入视频数据 | |
输入视频数据 |
音频变声与混响
API | 功能描述 |
设置变调参数 | |
设置变声音效模式 | |
设置混响音效模式 | |
设置美声音效模式 | |
设置混响音效类型 | |
设置均衡器音效类型 |
播放伴奏
API | 功能描述 |
开始伴奏混音 | |
停止伴奏混音 | |
设置伴奏音量 | |
设置伴奏推流音量 | |
获取伴奏推流音量 | |
设置伴奏本地播放音量 | |
获取伴奏本地播放音量 | |
暂停伴奏混音 | |
重新开始伴奏混音 | |
获取伴奏文件时长, 单位为毫秒 | |
获取伴奏文件播放进度,单位为毫秒 | |
设置伴奏文件的播放位置 |
播放音效
API | 功能描述 |
预加载音效文件 | |
删除预加载的音效文件 | |
开始播放音效 | |
暂停音效 | |
暂停所有音效 | |
恢复指定音效文件 | |
恢复所有音效文件 | |
停止播放音效 | |
停止播放所有音效 | |
设置音效推流混音音量 | |
获取音效推流混音音量 | |
设置音效本地播放音量 | |
获取音效本地播放音量 | |
设置所有音效推流混音音量 | |
设置所有音效本地播音量 |
SEI
API | 功能描述 |
是否开启SEI视频流,如开启将使用16x16黑帧/20fps | |
发送媒体扩展信息 | |
发送媒体扩展信息 |
Data Channel
API | 功能描述 |
发送数据消息 |
文件录制
API | 功能描述 |
开始文件录制 | |
停止文件录制 |
旁路直播
API | 功能描述 |
开启旁路直播 | |
更新旁路直播相关参数 | |
停止旁路直播 | |
获得旁路直播状态 | |
更新旁路直播相关参数 | |
停止旁路直播 | |
获得旁路直播状态 |
推拉RTS裸流
API | 功能描述 |
根据RtsUrl推流,目前同时只支持推一路流 | |
根据RtsUrl停止推流 | |
根据RtsUrl拉流,目前同时只支持拉一路流 | |
根据Rts user id停止拉流 | |
根据uid,暂停从服务端订阅RTS流 | |
根据uid,恢复从服务端订阅RTS流 |
网络质量探测
API | 功能描述 |
开始网络质量探测 | |
停止网络质量探测 |
其他接口
API | 功能描述 |
设置SDK日志文件保存路径 | |
设置日志等级 | |
设置是否上传日志文件,默认上传 | |
以json字符串的格式,更新外部输入参数 | |
以json字符串的格式,设置自定义属性 | |
获取自定义属性 | |
设置是否上传业务埋点,默认上传 | |
获取时间轴时间 |
回调接口
API | 功能描述 |
远端用户(通信模式)/(互动模式,主播角色)加入频道回调 | |
远端用户(通信模式)/(互动模式,主播角色)离开频道回调 | |
加入频道回调 | |
离开频道回调 | |
网络连接状态改变回调 | |
被服务器踢出/会议结束频道的消息回调 | |
音频推流变更回调 | |
视频推流变更回调 | |
屏幕流推流变更回调 | |
视频次要流推流变更回调 | |
音频订阅情况变更回调 | |
相机流订阅情况变更回调 | |
大小流订阅情况变更回调 | |
远端用户的音视频流发生变化回调 | |
远端用户的第一帧视频帧显示时触发这个消息 | |
预览开始显示第一帧视频帧时触发这个消息 | |
视频首包发送回调 | |
视频首包接收回调 | |
收到远端用户视频首帧的回调 | |
分辨率变化回调 | |
音频首包发送回调 | |
音频首包接收回调 | |
已解码远端音频首帧回调 | |
订阅的音频音量回调 | |
订通话前音频采集检测的音量回调 | |
订阅的当前说话人回调 | |
本地伴奏播放状态回调 | |
本地音效播放结束回调 | |
网络质量变化时发出的消息 | |
网络质量探测回调 | |
网络质量探测结果的回调 | |
当前会话统计信息回调 | |
本地视频统计信息回调 | |
远端视频统计信息回调 | |
本地音频统计信息回调 | |
远端音频统计信息回调 | |
旁路推流状态改变回调 | |
旁路推流状态改变回调(基于任务ID) | |
旁路任务状态改变回调 | |
旁路任务状态改变回调(基于任务ID) | |
远端用户静音/取消静音回调 | |
对端用户发送视频黑帧数据发送通知 | |
对端用户关闭相机流采集发送通知 | |
当用户角色发生变化时通知 | |
远端用户伴奏播放开始回调 | |
远端用户伴奏播放结束回调 | |
收到媒体扩展信息回调 | |
本地设备异常回调 | |
dataChannel消息回调 | |
远端视频流发生变化回调 | |
用户authInfo即将过期通知 | |
用户调用需要鉴权的接口,服务端返回信息过期 | |
AI agent处理结果回调 | |
可以开始发送data channel消息回调 | |
音频延时信息回调 | |
本地音频采集设备状态回调 | |
本地视频采集设备状态回调 | |
文件录制回调事件 | |
警告通知 | |
错误通知 | |
启动RTS URL推流结果 | |
结束RTS URL推流结果 | |
订阅RTS URL结果回调 | |
取消订阅使用RTS URL结果回调 | |
RTS URL预建联数目超限回调 | |
使用RTS UID 暂停订阅结果回调 | |
使用RTS UID 恢复订阅结果回调 | |
采集裸数据回调 | |
3A后数据回调 | |
推流数据回调 | |
播放数据回调 | |
推流数据和播放数据混音后回调 | |
远端拉流数据回调 |