- 最新动态
- 服务公告
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
-
客户端SDK参考
- 使用前必读
- SDK概述
- 隐私声明
- 合规使用指南
- Android SDK
- iOS/macOS SDK
- All Platform C++ SDK
- Web SDK
- 接入鉴权
- 附录
- 修订记录
-
常见问题
-
产品咨询
- SparkRTC支持哪些平台?
- SparkRTC Demo怎么体验?
- 在进行Windows的Demo使用或集成SDK时,提示微软C++标准库缺失,该如何获取?
- SparkRTC支持接入微信小程序吗?
- 实时音视频是什么?
- 实时音视频和直播有什么区别?
- SparkRTC是否支持在国外使用?
- SparkRTC RoomID是什么?取值区间值是多少?
- SparkRTC最多可以同时创建多少个房间?
- SparkRTC UserID是什么?取值范围是多少?
- 怎么理解SparkRTC的角色Role?
- SparkRTC最多可以支持多少个人同时视频通话?
- 实时音视频的时延是多少?
- SparkRTC是否支持连麦互动?
- SparkRTC是否支持双向的桌面推送?
- 实时音视频支持私有化部署吗?
- PC端实时音视频支持USB摄像头吗?
- 计费购买
- Signature相关
- 录制相关
-
SDK使用
- 移动端(Android/iOS)创建一个房间,是否支持PC端(MAC/Windows)接入?
- iOS平台如何缩减安装包体积?
- Android平台如何缩减安装包体积?
- iOS端是否可以监听远端离开房间?
- 背景音乐是否支持循环播放?
- SparkRTC是否支持调整背景音乐的播放进度?
- 支持监听房间成员进出房间吗?
- 如何监测断网和重连?
- 支持首帧渲染回调吗?能否监听画面开始渲染?
- 如何设置上行视频码率、分辨率和帧率?
- 有没有推荐的画面质量(码率、分辨率、帧率)相关参数配置?
- 如何实现横屏视频通话?
- 是否支持网络测速?如何操作?
- 是否支持音量大小提示?
- 自定义渲染支持哪些格式?
- SparkRTC支持iOS后台运行吗?
- 移动端如何实现录屏(屏幕分享)?
- 多人视频会议中,移动端和Web端可以进入同一房间吗?
- SparkRTC的Web端、移动端、PC端是不是同步的?
- Android SDK是否支持自定义采集数据?
- SparkRTC支持旁路推流吗?
- Windows端如何才能采集到被分享应用播放的声音?
- SDK是否支持断线重连机制?
- 如何创建房间?
- 两台手机同时运行SparkRTC APP,为什么无法互通?
- 鉴权是如何生成的?在什么时候生成?
- onVideoStats、onAudioStatus、onSubStreamStats回调触发时为什么程序会崩溃?
- 为什么本端听筒能听到自己的声音?
- setExternalAudioCapture(音频自采集)、setExternalVideoCapture(视频自采集)、setExternalMediaFrameOutput(视频自渲染)能在进入房间后开启吗?
- SparkRTC是否支持设置镜像画面?
- SparkRTC音视频过程中的上下行码率、分辨率、丢包率、音频采样率等信息怎么获取?
- SparkRTC是否支持设置本地采集音量?是否支持设置每个远端用户的播放音量?
- enableLocalVideo和muteLocalVideo有什么区别?
- enableLocalAudioStream和muteLocalAudio有什么区别?
- SparkRTC是否支持对房间进行权限校验?
- 接入PC端是否支持屏幕分享功能?
- SparkRTC是否支持将本地视频文件分享到实时音视频中?
- SparkRTC是否支持单纯的实时音频?
- 一个房间里可以同时有多路屏幕分享吗?
- SparkRTC是否支持1080P?
- 是否支持视频画面截图功能?
- 播放背景音乐是否支持在线音乐?
- 同一个页面中,可以创建N个RTC对象,通过N个UserID,分别登录到N个房间吗?
- Web端用宽高设置的推流分辨率适用于所有浏览器吗?
- Web端SDK在使用过程中拔掉摄像头,摄像头列表里面的数据如何清除?
- Web端SDK可以获取当前音量大小吗?
- Web端支持监听远端离开房间吗?
- Web端通话过程中为什么会出现回声、杂音、噪声、声音小?
- Web端如何切换摄像头和麦克风?
- SparkRTC支持白板功能吗?
- 相同UserID支持同时进入多个房间吗?
- SparkRTC房间的生命周期是多久?
- SparkRTC多人视频通话支持蓝牙耳机吗?
- SparkRTC多人视频通话支持仅订阅2/3/4人音频吗?
- 指定窗口分享,当窗口大小变化时,视频流的分辨率会跟着变化吗?
- 视频通话支持悬浮窗、大小画面切换功能吗?
- 发送自定义消息接口能实现聊天室、弹幕等功能吗?
- 支持查询所有的UserID吗?
- Web SDK中的checkSystemRequirements接口为什么会调用异常?
- 问题排查
-
产品咨询
- 文档下载
- 通用参考
展开导读
链接复制成功!
常见问题
- 加入房间时,userName必须填吗?
非必填。userName、userId由App自定义,但可以相同。
- userId:必填,string[64]类型,用户标识,userId需要保证应用内唯一。userId支持的字符包括:a-z、A-Z、0-9、连接符 '-'、下划线 '_'。
- userName:选填,string[128]类型,用户昵称。
- microphoneId跟cameraId在哪获取?为什么是必填的?
分别为麦克风ID和摄像头ID ,音视频通话必须的,即在创建流的时候采集ID对应的音频、视频。
使用getDevices、getCameras、getMicrophones接口可直接获取媒体输入输出、麦克风/摄像头设备ID 。
- 若摄像头不打开,是否显示默认的人像图标?
如果获取不到摄像头 ,但是能获取到麦克风,则视频是黑屏,音频有流。如果麦克风和摄像头都获取不到,则本地预览失败,不会显示默认的人像图标。
- 退出房间后摄像头没关,是不是需要释放摄像头?
退出房间不需要手动释放摄像头,会自动关闭,不再采集摄像头。
- 如何鉴权?在什么时候鉴权?
具体请参见接入鉴权。
- 客户端以joiner角色加入房间失败。
客户端调用join时传入的角色参数不对。role是数值型,如果客户端传入的是字符串型,则会加入房间失败。
- 创建本地流失败,控制台提示Cannot read property 'getUserMedia' of undefined,无法获取到媒体源。
可能有以下原因:
原因1:系统未允许应用访问摄像头等媒体源,解决方法请参见授权浏览器摄像头/麦克风访问方法。
原因2:由于浏览器的策略,仅允许通过https://方式或者localhost的方式访问用户的摄像头和麦克风权限。
原因3:检查摄像头等设备是否被其他应用占用了。
- 如果之前访问过使用Web SDK开发的App网站,又清理了该网站的权限,存在一定几率无法开启摄像头和麦克风。
在保证打开授权浏览器摄像头/麦克风访问权限的方法前提下。点开网页的左上角,将权限改为允许。如下图所示:
- 输入在线音频地址,且该地址可以在浏览器中打开,但是使用Web SDK的混音功能时,启动混音失败。
需要确认在线音频文件下载服务器是否支持跨域,由于浏览器的安全策略,必须要支持跨域,否则请求失败。
注意:混音只有对端可以听到,本端听不见。
- 音频TopN 模式(音频最大三方模式)是什么意思?
音频TopN模式也叫音频最大三方模式。开启音频TopN模式后,本地用户不需要通过调用接口,单独订阅某个远端用户的音频,即可接收到当前房间内音量值最大的三个用户的音频。具体接口调用可参见切换音频模式。
- 调用setVolume4TopThree设置音频最大三方音量值是设置房间内三个最大声音的用户的音量值吗?传参需要传一个参数还是三个参数?
是的。传参只需要传一个参数。
- 如果业务上App只能使用http协议,是否能够集成使用SparkRTC Web SDK ?
可以集成使用,但不推荐。需要用户手动关闭安全策略相关的开关。打开chrome页签,输入chrome://flags/#unsafely-treat-insecure-origin-as-secure,开启开关项,并把App的加载地址加入到忽略列表。
- Firefox浏览器中使用Web SDK,加入房间失败怎么办?
请排查Firefox浏览器的H264插件是否安装。浏览器中输入about:addons,跳转到插件安装页面,查看H264插件是否安装完成,如未安装请在该页面更新安装。
- 使用Mac Chrome浏览器屏幕分享失败,提示 "NotAllowedError: Permission denied by system" 或 "NotReadableError: Could not start video source" 时怎么办?
可能是由于未开启浏览器的屏幕录制权限导致。您可以通过在Mac的“设置 > 安全性与隐私 > 隐私 > 屏幕录制”中,打开Chrome屏幕录制授权后,重启Chrome浏览器。