入门指引 首次使用SparkRTC，您需要完成如下操作： 注册华为账号 ：单击进入注册页面。 完成实名认证：单击进入实名认证。 账户充值：为确保正常使用SparkRTC，您需要进行账户充值（超过1元）。 提交工单联系华为云技术客服，进行业务咨询。 图1 入门流程 SparkRTC的入门操作流程说明如表1所示。 表1 入门流程说明 序号 操作方法 操作说明 1 获取App ID和 域名 在SparkRTC控制台中创建应用后获取App ID和域名。 2 获取SparkRTC SDK 目前产品已转维，不再对外开放提供SDK开发包，如有疑问，请提交工单处理。 3 集成SparkRTC SDK 集成Android SDK 集成iOS SDK 集成MAC SDK 集成Windows SDK 集成Web SDK SparkRTC提供了Android、iOS、MAC、Windows和Web版本的SDK，您可以根据实际需求进行SDK的集成和开发。 4 实现SparkRTC基本功能 Android SDK功能开发 iOS SDK功能开发 MAC SDK功能开发 Windows SDK功能开发 Web SDK功能开发 集成SDK后，您需要实现SparkRTC的基本功能，如加入房间、发布和订阅流、离开房间等。 5 验证SparkRTC功能 SparkRTC基本功能开发完成后，您可以进行编译验证，其中roomId和userId可以自行定义。

客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUC CES S 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001 sdk internal error SDK内部错误，请联系技术支持。 RTC_ERR_CODE_WAIT_RSP_TIMEOUT 90000004 message response timeout 消息响应超时，请联系技术支持。 RTC_ERR_CODE_INVALID_PA RAM ETER 90000005 invalid parameter 参数传递错误，请参照API文档排查。 RTC_ERR_CODE_INVALID_OPERATION 90100001 illegal operation 非法操作，用户状态不正确。 RTC_ERR_CODE_NOT_SUPPORT_MEDIA_DEVICES 90100002 not support enumerate devices 浏览器不支持enumerateDevices方法。 RTC_ERR_CODE_NO_AVAILABLE_DEVICES 90100003 no available devices 没有找到可用设备，请排查设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_VIDEO_INPUT_DEVICES 90100004 no available video input devices 没有找到可用摄像头设备，请排查视频采集设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_AUDIO_INPUT_DEVICES 90100005 no available audio input devices 没有找到音频输入设备，请排查音频采集设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_AUDIO_OUTPUT_DEVICES 90100006 no available audio output devices 没有找到音频输出设备。 RTC_ERR_CODE_STATUS_ERROR 90100007 room status error 房间状态不正确，检查是否入会成功。 RTC_ERR_CODE_WEBSOCKET_NOT_CONNECTED 90100008 websocket connection state is not "CONNECTED" websocket 链接未成功，检查链接情况。 RTC_ERR_CODE_WAIT_CONFIG_FAIL 90100009 wait server config fail 获取下发配置失败，请联系技术支持。 RTC_ERR_CODE_PUBLISH_RESPONSE_FAIL 90100010 publish response fail 发布流响应失败，请联系技术支持。 RTC_ERR_CODE_REGION_NOT_COVERED 90100011 current region is not covered, service unavailable 没有找到服务端地址，请联系技术支持。 RTC_ERR_CODE_WEBSOCKET_CONNECT_TIMEOUT 90100012 websocket connect timeout websocket建链超时，请联系技术支持。 RTC_ERR_CODE_WEBSOCKET_RECONNECT_TIMEOUT 90100013 websocket reconnect timeout websocket重连超时，请联系技术支持。 RTC_ERR_CODE_WEBSOCKET_NOT_OPEN 90100014 websocket is not open websocket链接未打开，请联系技术支持。 RTC_ERR_CODE_WEBSOCKET_INTERRUPTED 90100015 websocket connection state is idle, interrupt operation websocket链接被强制关闭，一般为离会或者重连。 RTC_ERR_CODE_WEBSOCKET_CONNECT_ERROR 90100016 websocket connect error websocket监听onerror，服务端主动断链。 RTC_ERR_CODE_CAPTURE_PERMISSION_DENIED 90100017 capture failed, permission denied 采集失败，音视频设备采集权限未被授权。建议提示用户授权摄像头/麦克风访问权限。 RTC_ERR_CODE_CAPTURE_OVER_CONSTRAINED 90100018 capture failed, Constraint parameter invalid 采集失败，音视频采集设备不支持设置的采集约束。 RTC_ERR_CODE_CAPTURE_DEVICE_NOT_FOUND 90100019 capture failed, requested device not found 采集失败，设备未找到。建议在通话开始前引导用户检查通话所需的摄像头或麦克风等设备是够就绪。 RTC_ERR_CODE_CAPTURE_DEVICE_NOT_READABLE 90100020 capture failed, maybe device is occupied by other application 采集失败，设备被占用，请检查使用状态。建议提示用户“暂时无法访问摄像头/麦克风，请确保当前没有其他应用请求访问摄像头/麦克风，并重试”。 RTC_ERR_CODE_PLAY_NOT_ALLOW 90100021 the user didn't interact with the document first, please trigger by gesture 不允许播放。 RTC_ERR_CODE_ROLE_NO_PERMISSION 90100022 the user role have no permission to operate 用户角色没有权限，请检查用户角色。 RTC_ERR_CODE_ANSWER_SDP_INVALID 90100023 the answer sdp is invalid SDP协商错误，请联系技术支持。 RTC_ERR_CODE_MEDIA_UPSTREAM_UNSUPPORTED 90100024 the upstream media is not supported 浏览器不支持媒体采集。 RTC_ERR_CODE_MEDIA_NETWORK_ERROR 90100026 media connection establish failed, please switch network or try again later 媒体建链失败，请切换网络重试。 RTC_ERR_CODE_CLIENT_RELAY_ROOM_OVER_MAXNUM 90100027 relay room number over maximum number 跨房数量超过最大值。 RTC_ERR_CODE_CLIENT_RELAY_JOINER_OVER_MAXNUM 90100028 joiner already exist in relay rooms 跨房内主播人数超过最大值。 RTC_ERR_CODE_ROOM_STREAM_STATUS_PAUSED 90100029 room stream status paused 房间音视频暂停。 RTC_ERR_CODE_SIGNATURE_EXPIRED 90100030 signature expired 签名过期。 RTC_ERR_CODE_SIGNATURE_INVALID 90100031 signature invalid 签名非法。 RTC_ERR_CODE_WINDOW_OR_NAVIGATOR_UNSUPPORTED 90100032 window or navigator error 浏览器window或者navigator异常，请升级或更换浏览器。 RTC_ERR_CODE_CHROME_VERSION_UNSUPPORTED 90100033 the kernel Chrome version is earlier than 67. 浏览器chrome内核版本低于67，请升级或更换浏览器。 RTC_ERR_CODE_WEBSOCKET_UNSUPPORTED 90100034 the websocket component is missing 浏览器websocket能力不支持，请升级或更换浏览器 RTC_ERR_CODE_WEBRTC_AVC_ENCODE_UNSUPPORTED 90100035 RTCPeerConnection unsupport AVC encoders. WebRTC不支持远端画面渲染，请升级或更换浏览器。 RTC_ERR_CODE_WEBRTC_AVC_DECODE_UNSUPPORTED 90100036 RTCPeerConnection unsupport AVC decoders. WebRTC不支持本地画面传输，请升级或更换浏览器。 RTC_ERR_CODE_WEBRTC_WECHAT_UNSUPPORTED 90100037 browser not support, the model is not in the trustlist. 该机型不支持微信浏览器。 RTC_ERR_CODE_RTC_A CS 90100100 server internal exception 服务端内部错误，请联系技术支持。 RTC_ERR_CODE_RTC_CONTROL_ERROR 90100200 server internal exception 服务端内部错误，请联系技术支持。 RTC_ERR_CODE_SFU_ERROR 90100600 server internal exception 服务端内部错误，请联系技术支持。 父主题： 接口参考

实现步骤 请参见OBS帮助中心创建桶。若已有OBS桶，请直接执行步骤2。 创建的OBS桶所在区域必须为华北-北京四。 OBS桶授权。 登录 实时音视频 控制台。 在左侧导航树中选择“云资源授权”，进入桶授权页面。 在对应的OBS桶行单击“授权”，完成桶授权。 配置录制规则。 登录实时音视频控制台。 在左侧导航树中选择“应用管理”，进入应用管理页面。 在需要创建录制规则的应用行单击“录制配置”，进入录制配置页面。 在“录制规则”页签，单击“添加”，进入添加录制规则页面。 一个应用ID仅支持创建一个录制规则。 请您按照实际需求配置录制参数，参数说明如表1所示。 表1 录制参数说明 参数名 描述 存储-桶 存储录制文件的OBS桶。 目前录制文件仅支持存储到华北-北京四的OBS桶中。 区域 OBS桶所在的区域。 存储-路径 存储录制文件的OBS桶路径。 录制格式 录制文件的格式，支持HLS和MP4文件格式。 HLS规则 m3u8命名规则 录制m3u8文件的存储路径和文件的前缀。 默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。 录制周期 录制时长支持0-720分钟，最小录制周期为1分钟，最大录制周期为12小时，超过12小时，系统将按照命名规则生成新文件。如果录制周期为0，则整个流录制为一个文件。 最大断流合并时长 支持如下三种配置： 断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。 断流后不生成新文件：是指录制的直播流中断后，会和之前录制的文件合并为一个文件。最大断流合并时长为30天。 其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。 MP4规则 mp4命名规则 录制mp4文件的存储路径和文件的前缀。 默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。 录制周期 录制时长支持1-180分钟，最小录制周期为1分钟，最大录制周期为3小时，超过3小时，系统将按照命名规则生成新文件。 最大断流合并时长 支持如下两种配置： 断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。 其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。 单击“确定”，在录制规则列表中会增加一条新的录制规则。 图2 录制规则 您可以在录制规则列表中，根据实际需求选择是否开启自动录制功能。自动录制功能开启后，若该应用下有新创建的房间，则会按照已配置的录制规则自动对该房间中的实时音视频互动过程进行录制。 自动录制功能开启后，仅对同一应用下新创建的房间生效，自动录制功能开启前已创建的房间不生效。 加入房间。 录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC服务会根据配置的录制规则对正在直播的音视频进行录制。 若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启云端录制任务，SparkRTC才会根据API中的录制规则ID对实时音视频互动画面进行录制。 回放录制文件。 录制完成后，您可以在OBS控制台中或通过回调消息查看录制文件。 通过OBS控制台查看录制文件 登录OBS控制台。 在左侧导航栏中，选择“桶列表”。 在桶列表中单击存储SparkRTC录制文件的桶，进入“概览”页面。 在左侧导航栏，单击“对象”，查看录制文件信息。 您还可以对录制文件进行下载、分享等操作，具体请参见OBS帮助中心。

合流布局 在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。 九宫格模板 每个用户画面平铺在画布上，大小一致。根据用户数量，动态调整每个画面的大小和位置。最多支持25个画面。不同人数的实际布局效果如下图所示。 如果实际视频流的宽高比与视窗的宽高比不一致，视频画面会裁剪以适配视窗的大小。 中途有流退出房间，则该条流的画面会被后进入房间的流顶替。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。 支持背景图，如果房间内人数不足，显示背景图。 屏幕共享模板 屏幕分享（或者主讲人摄像头画面）始终占据屏幕左侧或者右侧大画面位置，其他用户依次垂直排列于旁边。最多支持17个画面。不同人数的实际布局效果如下图所示。 大视窗画面，可选择主讲摄像头流或共享屏幕流。 大视窗画面，显示指定的UID用户的视频，如果未指定或者指定用户未进入频道，大视窗区域显示背景色。 左侧大视窗为了保持内容的完整性采用缩放方式处理，右侧小视窗采用裁剪方式适配视窗的大小。 右侧小视窗画面按照加入房间的时间先后顺序排列。 右侧小视窗有流退出房间，则该条流的画面会被后进入房间的流顶替。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。 支持背景图，如果房间内人数不足，显示背景图。 自定义布局模板 支持用户自定义合流布局样式，可灵活设置用户画面的大小，指定用户画面在视频画布上的相对位置。 可自定义各个视频窗格在画布上的位置。 可自定义各个视频窗格的宽和高。 针对每一个窗格，可通过user_id指定显示房间内某一用户。 针对窗格，可自定义选择呈现摄像头流或者屏幕分享流。 如果实际视频流的宽高比与视窗的宽高比不一致，自定义布局场景下支持选择裁剪和缩放两种模式。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。 支持背景图，如果房间内人数不足，则显示背景图。

实现流程 创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。 由于单AZ桶的可靠性低于多AZ桶，为避免因OBS服务异常导致录制失败，建议您创建多AZ桶用于录制文件的存储。 OBS桶授权：在SparkRTC服务中对存储录制文件的OBS桶进行授权，允许SparkRTC服务将录制文件存储在对应的OBS桶中。 配置录制规则：为实时音视频互动配置录制规则，并开启自动录制功能，加入SparkRTC房间后，与应用中的录制规则ID相同的录制模板会自动生效，录制内容按录制设置存储至OBS中。还可以通过设置回调地址获取录制任务状态通知。 加入房间：录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC会根据配置的录制规则对正在直播的音视频进行录制。 若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启、查询和控制云端录制任务。SparkRTC服务才会根据接口中的录制规则ID对实时音视频互动画面进行录制。 回放录制文件：录制完成后，在已配置的回调地址中会收到录制任务的回调消息，您可以获取到录制文件的基本信息，也可以在OBS中管理录制文件，如下载、分享、删除等。 录制文件的分辨率与推流分辨率相关，按推流原分辨率进行录制。

实现步骤 请参见OBS帮助中心创建桶。若已有OBS桶，请直接执行步骤2。 创建的OBS桶所在区域必须为华北-北京四。 OBS桶授权。 登录实时音视频控制台。 在左侧导航树中选择“云资源授权”，进入桶授权页面。 在对应的OBS桶行单击“授权”，完成桶授权。 配置录制规则。 登录实时音视频控制台。 在左侧导航树中选择“应用管理”，进入应用管理页面。 在需要创建录制规则的应用行单击“录制配置”，进入录制配置页面。 在“录制规则”页签，单击“添加”，进入添加录制规则页面。 一个应用ID仅支持创建一个录制规则。 请您按照实际需求配置录制参数，参数说明如表1所示。 表1 录制参数说明 参数名 描述 存储-桶 存储录制文件的OBS桶。 目前录制文件仅支持存储到华北-北京四的OBS桶中。 区域 OBS桶所在的区域。 存储-路径 存储录制文件的OBS桶路径。 录制格式 录制文件的格式，支持HLS和MP4文件格式。 HLS规则 m3u8命名规则 录制m3u8文件的存储路径和文件的前缀。 默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。 录制周期 录制时长支持0-720分钟，最小录制周期为1分钟，最大录制周期为12小时，超过12小时，系统将按照命名规则生成新文件。如果录制周期为0，则整个流录制为一个文件。 最大断流合并时长 支持如下三种配置： 断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。 断流后不生成新文件：是指录制的直播流中断后，会和之前录制的文件合并为一个文件。最大断流合并时长为30天。 其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。 MP4规则 mp4命名规则 录制mp4文件的存储路径和文件的前缀。 默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。 录制周期 录制时长支持1-180分钟，最小录制周期为1分钟，最大录制周期为3小时，超过3小时，系统将按照命名规则生成新文件。 最大断流合并时长 支持如下两种配置： 断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。 其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。 单击“确定”，在录制规则列表中会增加一条新的录制规则。 图3 录制规则 您可以在录制规则列表中，根据实际需求选择是否开启自动录制功能。自动录制功能开启后，若该应用下有新创建的房间，则会按照已配置的录制规则自动对该房间中的实时音视频互动过程进行录制。 自动录制功能开启后，仅对同一应用下新创建的房间生效，自动录制功能开启前已创建的房间不生效。 加入房间。 录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC服务会根据配置的录制规则对正在直播的音视频进行录制。 若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启云端录制任务，SparkRTC才会根据API中的录制规则ID对实时音视频互动画面进行录制。 回放录制文件。 录制完成后，您可以在OBS控制台中或通过回调消息查看录制文件。 通过OBS控制台查看录制文件 登录OBS控制台。 在左侧导航栏中，选择“桶列表”。 在桶列表中单击存储SparkRTC录制文件的桶，进入“概览”页面。 在左侧导航栏，单击“对象”，查看录制文件信息。 您还可以对录制文件进行下载、分享等操作，具体请参见OBS帮助中心。

实现流程 创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。 由于单AZ桶的可靠性低于多AZ桶，为避免因OBS服务异常导致录制失败，建议您创建多AZ桶用于录制文件的存储。 OBS桶授权：在SparkRTC服务中对存储录制文件的OBS桶进行授权，允许SparkRTC服务将录制文件存储在对应的OBS桶中。 配置录制规则：为实时音视频互动配置录制规则，并开启自动录制功能，加入SparkRTC房间后，与应用中的录制规则ID相同的录制模板会自动生效，录制内容按录制设置存储至OBS中。还可以通过设置回调地址获取录制任务状态通知。 加入房间：录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC会根据配置的录制规则对正在直播的音视频进行录制。 若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启、查询和控制云端录制任务。SparkRTC服务才会根据接口中的录制规则ID对实时音视频互动画面进行录制。 回放录制文件：录制完成后，在已配置的回调地址中会收到录制任务的回调消息，您可以获取到录制文件的基本信息，也可以在OBS中管理录制文件，如下载、分享、删除等。 录制文件的分辨率与推流分辨率相关，按推流原分辨率进行录制。

为什么无法打开摄像头？ 摄像头打开失败有多种原因，建议您参照如下方面进行初步排查： 确认摄像头权限是否已打开。Android和iOS系统都有权限管理，请在系统设置中进行检查。同时Android的部分安全软件也会进行权限管理。 检查是否有其他应用占据了摄像头。若有请关闭后，重启手机再打开摄像头。 摄像头硬件问题。打开系统自带的拍摄视频程序看是否可以录像。 若上述方法均无法解决问题，建议您提交工单，申请华为云技术客服协助解决问题。 父主题： 问题排查

为什么视频会出现卡顿？ 网络、设备性能等原因都可能导致视频出现卡顿。若出现视频播放卡顿问题，您可以先参考如下方法进行初步排查。 自检操作，您可以从以下几方面进行排查。 判断是持续性的还是一次性的卡顿。一次性的卡顿是由网络和设备的随机性导致，属于正常现象。 检查网络状态，判断连接是否正常。 如果网络连接正常但依然卡顿，请尝试更换网络连接，检查在网络状态良好的条件下是否依然卡顿。 如果网络良好且条件允许，请尝试更换设备。 如果有视频前处理，例如美颜等，请先关闭前处理，检查卡顿是否由于前处理导致。 通过视镜功能进行端到端链路检查。 若上述方法均无法解决问题，建议您提交工单，申请华为云技术客服协助解决问题。 父主题： 问题排查

如何处理视频黑屏问题？ 常见的视频黑屏问题有以下三种情况： 本地视频黑屏远端视频正常。 本地视频正常远端视频黑屏。 本地远端视频都黑屏。 可能导致出现视频黑屏的原因如下： 本地网络信号差或者信号中断。 通话中有一方的网络出现问题，其他人也会看不到此用户的视频。 用户主动关闭了视频。 您可以通过视镜功能进行端到端链路检查。 若问题仍未解决，建议您提交工单，申请华为云技术客服协助解决问题。 父主题： 问题排查

操作步骤 登录实时音视频控制台。 在左侧导航树中选择“用量统计”，进入用量统计页面。 您也可以通过在“应用管理”页面的“操作”列，单击“用量”跳转到“用量统计”页面进行查看。 选择需要查看的时间和应用名称，即可查看到相关统计数据及明细。 统计图中展示了不同分辨率档位（标清/高清/超清）的视频通话时长和纯语音通话时长统计数据。在统计图中您可以进行如下操作： 单击如下图标可以选看或取消选看不同规格的音视频通话时长统计情况。 图1 规格图标 将鼠标指针停留在统计数值线上，可以查看各规格的音视频通话时长。 将鼠标指针停留在统计图上，滚动鼠标滚轮可针对某时间跨度范围内的统计图时间横轴进行拉大或缩小整体占比。 图2 音视频时长统计 “用量统计”中记录的通话时长仅供数据分析和参考使用，计费数据请以账单为准。

看板 您可以在看板页签中查看项目的整体状态，包含当前房间/用户数、5秒加入房间成功率和音视频流畅度，以及通话的异常数据。 图1 看板 当前房间数：从第一个用户加入房间到最后一个用户离开房间，计为一个通话房间。 当前用户数：当前在线用户数（同用户名不同房间，计为多人）。 5秒加入房间成功率：5秒内加入房间成功人数/尝试加入房间人数。 音频流畅度：（总音频时长- 音频卡顿时长 ）/总音频时长。音频卡顿达到200ms，即被计入卡顿时长。 视频流畅度：（总视频时长- 视频卡顿时长 ）/总视频时长。视频卡顿达到600ms，即被计入卡顿时长。 中国地图：展示各地域的在线用户数。 报警：动态显示栏，仅在发生异常事件时显示，最多展示6条报警信息。异常事件及对应的阈值如表1所示。 表1 异常事件说明 异常事件 检测阈值 系统CPU占用高 80% App CPU占用高 70% 音频上行网络延时 500ms 音频上行网络抖动 500ms 视频上行网络延时 500ms 视频上行网络抖动 500ms 音频下行网络延时 500ms 音频下行网络抖动 500ms 视频下行网络延时 500ms 视频下行网络抖动 500ms 上行音频丢包 20% 上行视频丢包 20% 下行音频丢包 20% 下行视频丢包 20% 下行视频卡顿 5% 下行音频卡顿 3%

网络 您可以在网络页签中查看客户端音视频上行优质传输率，及各地域的上行优质传输率。 您可以在页面上方调整需要查看的时间范围，以及指定是否实时更新图表数据。 总览：展示客户端音视频上行优质传输率。 图12 总览 客户端视频上行优质传输率：从发送端到SparkRTC的视频优质传输率。 客户端音频上行优质传输率：从发送端到SparkRTC的音频优质传输率。 分布：将地域按在线用户数降序排列，并显示各地域的客户端音视频上行优质传输率。各数据项说明请参见网络总览。

查看用户操作事件 分别在视频选看、音频选看和辅流选看页签的右侧操作列单击“事件”，可以查看用户在通话过程中的所有操作事件详情。通过分析用户在客户端的操作步骤，复现相应的场景，辅助定位软件问题和分析bug。具体事件类型及ID如表1所示。 图5 操作事件详情 表1 用户操作事件说明 事件ID 事件类型 1 加入房间 2 离开房间 3 视频选看/批量选看 5 静音/取消静音 6 切换网络 7 开启/关闭摄像头 9 切换设备 10 DNS查询、TCP/TLS建链、首帧显示起止时间 11 切换角色 12 开始发送媒体流 13 媒体出流成功 14 辅流共享 16 音频选看/取消选看 17 跨房间 18 信令/媒体通道连接 19 上行视频设置 20 下行音频设置 21 服务器调度失败 22 推流成功率打点 23 拉流成功率打点

分析通话质量问题 在用户详情页面可查看通话基本信息、用户画像信息、视频选看数据和音频选看数据和辅流选看数据，如图4所示。 图4 用户详情页面 其中，音视频选看和辅流选看页签中展示的是从特定发送端到接收端的音视频质量指标详情，您可以通过分析各项质量指标，找到通话体验质量问题所在。 通话基本信息：可查看房间ID、应用ID、域名、房间状态、整段通话的起止时间。 用户画像信息：可查看用户在线时长、5s加入房间失败次数、推拉流失败次数。 视频选看：展示选定视频通话的发送端与接收端的质量监控数据，包含视频分辨率、丢包率、卡顿率、帧率、码率数据。 音频选看：展示选定音频通话的发送端与接收端的质量监控数据，包含音频丢包率、卡顿率、码率。 辅流选看：展示选定的发送端用户与对应接收端用户共享屏幕（窗口）的质量监控数据。包含码率、帧率、卡顿率、丢包率、分辨率、抖动和时延。