华为云用户手册

setVideoProfile setVideoProfile(profile: string|RTCVideoProfile,resolutionId?: string): void 【功能说明】 设置视频主流配置，如分辨率、帧率和码率等。如果未调用该接口设置，则SDK设置默认值为360p_2。如果该流已经发布，则该流会自动重新发布到远端。 【请求参数】 profile：必选，string类型或RTCVideoProfile类型。 若为string类型，则相关的分辨率、帧率和码率如表3。 若为RTCVideoProfile类型，则需要根据实际情况进行配置，推荐使用已定义的“profile”。输入不合法时，默认使用360p_2。 表3 profile 对应的分辨率、帧率和码率 profile 分辨率 帧率 最小码率（kbps） 最大码率（kbps） 90p_1 160 x 90 15 64 110 90p_2 120 x 90 15 64 110 120p_1 160 x 120 15 64 120 120p_2 120 x 120 15 64 110 180p_1 320 x 180 15 80 320 180p_2 240 x 180 15 80 170 180p_3 180 x 180 15 64 130 240p_1 320 x 240 15 100 400 240p_2 240 x 240 15 80 320 270p_1 480 x 270 15 160 600 300p_1 400 x 300 15 200 500 360p_1 640 x 360 15 200 800 360p_2 480 x 360 15 200 700 360p_3 360 x 360 15 150 600 450p_1 800 x 450 15 300 950 480p_1 640 x 480 15 250 900 480p_2 480 x 480 15 200 800 540p_1 960 x 540 15 400 1000 630p_1 1120 x 630 15 450 1150 720p_1 1280 x 720 15 500 1500 720p_2 960 x 720 15 450 1100 1080p_1 1920 x 1080 15 600 2000 1080p_2 1440 x 1080 15 550 1700 resolutionId：可选，string类型。在双流场景下，指定要设置的分辨率Id的视频，如果不指定，默认选择最高的分辨率的视频。 RTCVideoProfile类型定义为：{ width：可选，number类型，分辨率的宽度，单位为像素。 height：可选，number类型，分辨率的高度，单位为像素。 frameRate：可选，number类型，视频帧率，单位为帧/秒。 minBitrate：可选，number类型，视频最小码率，单位为bps。 maxBitrate：可选，number类型，视频最大码率，单位为bps。 } 【返回参数】 无 需注意码表中单位为kbps，接口传参的单位为bps，实际调用接口时需进行转换。 自定义采集的流（使用videoSource创建的Stream）不支持动态调用此接口，仅支持摄像头采集的流调用。 由于设备采集能力、系统性能以及浏览器的限制，视频分辨率，帧率，码率的实际值不一定能够完全匹配设定值，这种情况下浏览器会自动调整分辨率，尽可能匹配设定值，具体分辨率以实际采集到的分辨率为准。 能否采集1080p及以上的分辨率取决于采集设备能力以及系统性能，iOS Safari不支持采集1080p。 码表中的1080p分辨率为2.0.0版本新增，1.0版本如需采集1080P分辨率，请使用自定义参数的方式设置。 Firefox不支持自定义帧率（默认为30fps）。 如果上表的Profile不符合您的要求，用户可以根据自身业务需求自定义Profile。

connection-state-changed 【事件说明】 Client连接状态变更事件，Client连接状态变更会收到该事件通知。 【回调参数】 ConnectionStateInfoEvent：{ prevState：必选，ConnectionState类型，变更前状态。 curState：必选，ConnectionState类型，变更后状态。 } 连接状态ConnectionState的取值如下所示： CONNECTING：连接建立中。 CONNECTED：连接已连接。 RECONNECTING：重新连接中。 DISCONNECTED：连接已断开。

signature-expired 【事件说明】 签名过期事件。 【回调参数】 errorInfo：错误信息。必选，ErrorInfo类型。 ErrorInfo 定义为：{ errorCode：错误码。必选，string类型。 errorMsg：必选，string类型。取值如下面的取值示例中所示。 } 取值示例，如下所示： 签名过期：{ errorCode: '90100030' errorMsg: 'signature expired' } 签名无效：{ errorCode: '90100031' errorMsg: 'signature invalid' } 监听到签名过期事件后可通过错误码区分是签名无效还是签名过期，签名过期后可通过renewSignature接口更新签名。

mute-audio 【事件说明】 远端用户禁用音频通知事件，当远端用户禁用音频后，流接收端会收到该事件通知。 【回调参数】 mediaStatus：必选，MediaStatusNotifyInfo类型。 MediaStatusNotifyInfo包含如下属性： roomId：必选，string[64]类型。 userId：必选，string[64]类型。 status：必选，MediaStatusAction类型。MediaStatusAction枚举值定义如下所示： 1：媒资状态可用。 2：媒资状态不可用。 reason：必选，MediaStatusReason类型。MediaStatusReason枚举值定义如下所示： 0：媒体离线。 1：媒体静音。 2：媒体不静音。

remote-user-name-changed 【事件说明】 远端用户昵称变更事件。该事件为1.5.0版本新增。 【回调参数】 userNameChangedEvent：必选， UserNameInfo类型。 UserNameInfo定义为：{ roomId：必选，string[64]类型，房间Id。 userId：必选，string[64]类型，用户Id。 userName：必选， string[256]类型，修改后的用户昵称。 }

recording-device-changed 【事件说明】 本地录音设备变更事件，当本地录音设备变更时触发。 【回调参数】 DeviceChangedEvent：必选，DeviceChangedInfo类型，设备变更详情。DeviceChangedInfo定义参考camera-changed中的说明。 麦克风采集设备，拔插后需要应用层进行相应的处理，如：拔除麦克风的时候是否切换其他麦克风采集设备重新采集；插入麦克风的时候是否使用新插入设备进行重新采集。

network-quality 【事件说明】 网络上下行质量报告事件，用户加入房间后，SDK在网络质量变化的时候会触发一次该事件，报告用户的本地网络上下行质量情况。 【回调参数】 NetworkQualityEvent：必选， NetworkQualityInfo类型，网络上下行质量详情。 NetworkQualityInfo定义为：{ uplinkNetworkQuality：必选，number类型，上行网络质量。枚举值如下： 0：质量未知。 1：质量极好。 2：质量较好。 3：质量一般。 4：质量差。 5：质量极差。 6：网络连接断开。 downlinkNetworkQuality：必选，number类型，下行网络质量。枚举值如下： 0：质量未知。 1：质量极好。 2：质量较好。 3：质量一般。 4：质量差。 5：质量极差。 6：网络连接断开。 }

stream-interrupted 【事件说明】 远端流的码流中断事件。中断表示在 enableStreamStateDetection 接口参数 interval 设置的统计周期内未接收到有效视频帧。该事件为 1.4.0 版本新增。 【回调参数】 streamInterruptedEvent：必选，UserList[]类型，已订阅且无视频码流的用户列表。 UserList定义为：{ userId：必选，string类型，用户Id。 isScreen：必选，boolean类型，true表示对应用户的辅流，false表示对应用户的主流。 }

rtc-stats 【事件说明】 音视频流数据统计事件。该事件为2.0.3版本新增。 【回调参数】 rtcStatsInfo：必选， rtcStatsInfo[]类型。 rtcStatsInfo定义为：{ userName：必选，string类型，用户昵称。 isRemote：必选，boolean类型，是否为远端流，true表示远端流，false表示本地流。 streamType：必选，ContentType类型，流类型。ContentType类型的枚举值如下：{ main：string类型，表示主流。 middle1：string类型，表示主流，middle1~middle4码流依次降低。 middle2：string类型，表示主流，middle1~middle4码流依次降低。 middle3：string类型，表示主流，middle1~middle4码流依次降低。 middle4：string类型，表示主流，middle1~middle4码流依次降低。 slides：string类型，表示主流视频分辨率最小的流。 desktop：string类型，表示共享流。 } mediaType：必选，MediaType类型，媒体类型，音频或视频。 bitrate：必选，number类型，音视频流码率，单位为kbps。 frameRate：必选，number类型，视频帧率，单位为帧/秒。 rtt：必选，number类型，表示SDK到边缘服务器的RTT (Round-Trip Time)，单位毫秒。只有本地流才有rtt 值。 jitter：必选，number类型，音视频流抖动值。 pktLossRate：必选，number类型，音视频流丢包率。 }

client-banned 【事件说明】 用户被踢下线事件，当用户以相同的userId 在其他Client加入相同的房间后，被踢的Client会收到该事件通知。 【回调参数】 clientBannedEvent：必选，ClientBanInfo类型， ClientBanInfo定义为：{ userId：必选，string[64]类型，被踢用户标识。 reason：必选，string类型，原因描述。 }

camera-changed 【事件说明】 本地摄像头设备变更事件，当插、拔本地摄像头时触发。 【回调参数】 DeviceChangedEvent：必选，DeviceChangedInfo类型，设备变更详情。 DeviceChangedInfo 定义为：{ deviceId：必选，string类型，设备deviceId。 state：必选，DeviceChangeMode类型，DeviceChangeMode枚举值定义如下： ADD：设备添加。 REMOVE：设备移除。 } 视频采集设备，拔插后需要应用层进行相应的处理，如：拔除摄像头的时候是否切换其他视频采集设备重新采集；插入摄像头的时候是否使用新插入设备进行重新采集。

volume-indicator 【事件说明】 音频TopN模式下，房间中当前音量最大的用户提示事件。 【回调参数】 userVolumeInfos：必选， UserVolumeInfo[]类型。 UserVolumeInfo定义为：{ user_id：必选，string类型，用户Id。 volume：可选，number类型，取值范围为[0,100]。 } 该事件仅在音频TopN模式下生效，1.5.0版本新增。

live-streaming-updated 【事件说明】 旁路推流状态更新事件。该事件为2.0.1版本新增。 【回调参数】 urlStatus：UrlStatus[]类型，所有CDN推流状态更新。UrlStatus定义如下： url：必选，string类型，表示CDN推流URL status：必选，number类型，表示当前推流状态。 0：初始化。 1：链接正常且有流。 2：链接正常但无流。 3：异常重试。 4：处理失败。 errorCode：可选，number类型，表示详细的失败原因，支持的枚举值如下： 0： 正常。 1： 内部错误。 2： 地址解析失败。 3： 连接失败。 4： RTMP握手失败。 5： 内存错误。 6： 参数错误。 7： 重试失败。 8： 响应超时失败。

peer-leave 【事件说明】 远端用户离开房间事件，远端用户离开房间后会收到该事件通知。 【回调参数】 peerLeaveEvent：必选，PeerLeaveInfo 类型，用户离开信息。 PeerLeaveInfo 定义为：{ userId：必选，string[64]类型，用户标识。 userName：可选，string[256]类型，用户昵称。 reason：可选，HRTCLeaveReason类型。 } HRTCLeaveReason定义为：{ code：number类型, 离开原因枚举，取值如表2 离开房间原因所示。 msg：string类型，原因描述。 } 表2 离开房间原因 枚举值 描述 0 用户主动离开 1 服务器异常 2 sfu服务故障 3 服务不可达503 4 内部错误 5 被踢出房间 6 签名过期 7 重连超时 8 网络检测，UI不需要关注该错误码，不对外体现 9 用户移除 10 房间解散

隐私声明 华为云SparkRTC SDK是由 华为云计算 有限公司（以下简称“我们”或“华为云”）面向华为云客户提供，方便用户接入 实时音视频 。华为云客户根据开发文档和用户指南，在其应用中集成SparkRTC SDK后，我们将通过被集成的SparkRTC SDK向华为云客户面向的最终用户（以下简称“您”或“用户”）提供相关服务，处理华为云客户的应用相关的数据，相关数据中可能包含您的个人信息。华为云非常重视您的个人信息和隐私保护，我们将会按照法律要求和业界成熟的安全标准，为您的个人信息提供安全保护措施。 我们将通过本声明向您说明我们如何收集、使用、披露、保护、存储及传输您的个人信息。 请注意，我们要求集成华为云SparkRTC SDK的所有华为云客户，必须做到严格遵循法律法规、开发者协议去处理您的个人信息。在接入、使用各开放能力前，华为云客户必须在其产品应用的隐私政策中，向您告知其集成SDK处理个人信息的基本情况，并获取您的同意或取得其他合法性基础。但我们无法控制华为云客户及其开发的应用如何处理华为云客户所控制的个人信息，也不对其行为负责。我们建议您认真阅读华为云客户的应用相关用户协议及隐私政策。在确认充分了解并同意，华为云客户如何处理您的个人信息后，再使用华为云客户的应用。 一、我们如何收集和使用您的个人信息 华为云仅会根据本声明以下所述目的和方式收集和使用您的个人信息。如果我们要将收集的个人信息用于本声明未载明的其他目的，我们会以合理的方式自行或通过华为云客户明确向您告知，并再次获取您的同意或取得其他合法性基础。如果SDK存在扩展功能，或收集和使用了您的可选个人信息，我们会在下文特别说明。 实时音视频的功能 为了向您提供实时音视频的功能，我们会处理您的音视频流，用于实时音视频的采集、编码、传输、播放等。这些内容数据不会被存储，仅在服务器内存中缓存，直播结束后自动清除。 实时音视频体验指标及问题定位的功能 为了向您提供实时音视频体验指标功能以及问题定位的功能，我们会处理您的IP地址、运营商信息、WiFi状态、浏览器信息、操作系统信息、设备型号等数据，用于对实时音视频的的分辨率、帧率、码率、卡顿率、丢包率、在线人数、视频质量等指标进行统计，以及用于协助您进行业务功能的问题定位和分析。您的上述数据将在中华人民共和国境内处理，这些内容数据的存储期限默认为90天。此为可选功能，可通过SDK接口打开关闭。 您的上述数据在中华人民共和国境内处理，我们不会将上述数据用作其他用途。您完全拥有上述数据所有权及控制权，实时音视频SDK仅接受委托处理您的数据。 二、设备权限调用 当您使用相应功能及服务时，我们会通过华为云客户的应用向系统申请您设备的相应权限。您可以在设备的设置功能或“隐私设置”中，查看权限状态，并选择开启或关闭部分或全部权限。华为云客户在集成使用相应开放能力时，可自行决定权限的调用范围，华为云客户向您说明权限调用的用途。您根据华为云客户的应用请求，开启任一权限，即代表授权我们处理相关个人信息来为您提供相应服务；一旦您关闭任一权限即代表您取消了授权，我们将不再基于对应权限继续处理相关个人信息，可能无法继续为您提供该权限所对应的功能。请注意，您关闭权限的决定，不会影响此前基于您授权所进行的个人信息处理活动的效力。当前华为云实时音视频SDK需要申请的权限如下： 权限 权限描述 使用目的 相机权限 使用摄像头 当您使用通话功能时，您可以选择开启该权限，用于给其他参与人传输您的视频画面 麦克风权限 使用麦克风 当您使用通话功能时，您可以选择开启该权限，用于给其他参与人传输您的语音 联网 访问网络 当您使用通话功能时，用于完成通话音视频文件的传输 三、对未成年人的保护 在您开始使用本服务时，须承诺您是成年人。若您是未成年人，须您的父母或监护人同意您使用本服务及相关服务条款。 如果未成年人在未经父母或监护人同意的情况下，向我们提供了个人信息，父母或监护人可以联系我们，停止收集、使用或披露其个人信息。 如果我们发现在未事先获得可证实的父母或监护人同意的情况下，收集了未成年人的个人信息，会设法尽快删除相关数据。 如果华为云客户使用本服务用于教育用途，且您的最终用户可能是未成年人，请确保您的最终用户使用本服务前已获得其父母或监护人的明确同意。 四、管理您的个人信息 华为云非常尊重您对个人信息的关注，我们将遵照相关法律法规的要求，协调、支持并保障您行使访问、复制、更正或删除个人信息操作的主体权利。 由于您是通过华为云客户的应用使用华为云SparkRTC SDK和服务，如果您希望访问、复制或更正与华为云SparkRTC SDK的个人信息，您应通过华为云客户的应用提供的路径实现您的个人信息主体权利。 为保障您访问、复制、更正或删除个人信息的权利实现，我们在与华为云客户的协议中，明确要求华为云客户承诺根据法律法规要求，向您提供便捷的权利实现方式。同时，我们的开放能力也向华为云客户提供了相关的接口，支持华为云客户通过接口调用方式来执行您关于个人信息的访问、复制、更正、删除的权利请求。您也可以通过本声明中“如何联系我们”所述联系方式与我们取得联系，我们将尽力协调、支持并保障您的上述权利实现。 当您直接向我们提出个人信息主体权利时，为了保障您的数据安全和其他合法权益，我们可能会对您的身份进行验证并要求您提供验证身份所必要的个人信息，同时我们也可能会向华为云客户提供收集的身份验证信息以核实您的身份。在验证确认您的身份后，我们会根据法律法规要求及时响应您的相关请求。 如您对您的数据主体权利有进一步要求或存在任何疑问、意见或建议，可通过本声明中“如何联系我们”所述方式与我们取得联系，并行使您的相关权利。 五、信息存储地点及期限 存储地 上述信息将会传输并保存至中华人民共和国境内的服务器。 存储期限 音视频数据在拉流结束后，会立即删除。其他数据会在使用结束90天后删除。 我们仅在实现本声明所述目的所必需的时间内，保留您的个人信息。并在超出保留时间后，删除或匿名化处理您的个人信息，除非法律法规另有要求。 六、如何联系我们 我们设立了个人信息保护专职部门。当您有任何疑问、建议、投诉、请求，请通过访问隐私问题页面与我们联系。我们将尽快处理您提交的问题，并在15个工作日或法律法规规定的期限内，答复您的问题。 如果您对我们的回复不满意，特别是认为我们的个人信息处理行为损害了您的合法权益，您还可以向有管辖权的个人信息保护机构或其他监管部门进行投诉或举报。 一般情况下，我们会尽最大努力响应和处理您的请求。结合您的请求或问题的复杂程度，我们可能会有所延迟，但我们会告知您延迟的理由。

getVideoTrack getVideoTrack(resolutionId?:string): MediaStreamTrack 【功能说明】 获取视频轨道。 【请求参数】 resolutionId：可选，string类型。指定分辨率Id，如果不指定，默认选择分辨率最高的视频。 【返回参数】 MediaStreamTrack 类型。MediaStreamTrack类型详情可参见MediaStreamTrack。

stop stop(option?: StopOption): void 【功能说明】 停止播放音视频流。 【请求参数】 option：可选，StopOption类型，表示停止播放的选项。如果不传，则停止该流的音频和所有分辨率的视频。 StopOption类型定义如下：{ audio：可选，boolean类型。表示是否停止音频。默认为false。 video：可选，boolean类型。表示是否停止视频。默认为false。 resolutionIds：可选，string[] 型。在video为true的时候有效。指定停止播放的分辨率Id 的视频，如果不传resolutionIds，则默认停止所有分辨率的视频。 } 【返回参数】 无

close close(option?: CloseOption): void 【功能说明】 关闭音视频的播放。对于本地流，该方法在关闭播放的同时会关闭音视频采集，释放设备资源占用。 【请求参数】 option：可选，CloseOption类型，表示关闭音视频的选项。如果option不填写，则关闭音频和所有分辨率的视频。 CloseOption类型定义如下：{ audio：可选，boolean类型。表示是否关闭音频。默认为false。 video：可选，boolean类型。表示是否关闭视频。默认为false。 resolutionIds：可选，string[]类型。在video为true的时候有效。指定关闭播放的分辨率Id的视频，如果不传resolutionIds，默认关闭所有分辨率的视频。 } 【返回参数】 无

getStreamInfo getStreamInfo(): StreamInfo 【功能说明】 获取已经初始化的本地流，或者收到的远端流的的信息。 【请求参数】 无 【返回参数】 StreamInfo 类型定义如下：{ videoProfiles：RTCVideoProfileInfo[]类型。 audioProfile：RTCAudioProfile类型。 } RTCVideoProfileInfo类型定义如下：{ resolutionId：string类型，表示分辨率Id。 hasTrack：boolean类型，表示该分辨率的视频是否具备可播放的track。 width：number类型，分辨率的宽度，单位为像素。 height：number类型，分辨率的高度，单位为像素。 frameRate：number类型，视频帧率，单位为帧/秒。 minBitrate：number类型，视频最小码率，单位为bps。 maxBitrate：number类型，视频最大码率，单位为bps。 } RTCAudioProfile类型定义如下：{ sampleRate：number类型，表示音频采样率。 channelCount：number类型，表示音频声道数。 bitrate：number类型，表示音频码率，单位为bps。 }

getVideoSnapshot getVideoSnapshot(resolutionId?: string,format?: string, encoderOptions?: number): string 【功能说明】 获取视频截图 【请求参数】 resolutionId：可选，string类型。双流场景，指定需要截图的视频分辨率Id，resolutionId可通过接口getStreamInfo 获取。如果不传resolutionId，则默认对分辨率最高的视频流截图。 format：可选，string类型。表示截图的格式，可填‘jpeg’、‘webp’、'png'。如果不传format，则默认使用png格式截图。 encoderOptions：可选，number类型。format填‘jpeg’或者‘webp’时生效，表示图片质量，值范围【0,1】，默认值为1。 【返回参数】 string类型，表示视频截图对象的url，当视频未播放，或者resolutionId错误时，返回的string为空。

常见问题 调用加入房间接口成功后，再调用pushExternalVideoFrame返回90000001 SDK内部系统错误 需要收到加入房间成功回调通知后，才能调用pushExternalVideoFrame。 joiner和player都加入房间成功，joiner调用pushExternalVideoFrame返回0，但是player没有收到onRenderVideoFrame回调 需要接收端在收到onUserJoined消息后，在主线程里调用pullRemoteVideo和startRemoteStreamView。 startRemoteStreamView会返回90000008设置远端窗口失败错误 startRemoteStreamView的调用是需要放在主线程，不能在onUserJoined调用，否则会返回90000008错误码。 1080p经过RTC传输后，被自动缩放且颜色改变 老版本SDK不支持1080p。 推流1080p，接收到的是360p的流 关闭发送端设置发流编码参数分辨率自适应，关闭收端分辨率自适应。 int setVideoEncoderConfig(unsigned int totalBitRate, HRTCVideoEncParam *encoderParams, unsigned int encoderCount) // HRTCVideoEncParam.disableAdjustRes=trueint setVideoEncoderConfig(const HRTCVideoEncParam &encParam) // HRTCVideoEncParam.disableAdjustRes=trueint startRemoteStreamView(const char* userId, view_t view, HR TCS treamType streamType, bool disableAdjustRes) // disableAdjustRes=true rtc设置了音频的自渲染和自采集，但是不推音频的pcm数据，onPlaybackAudioFrame也会收到回调 这是正常现象，SDK会定时回调onPlaybackAudioFrame，里面是空白语音包。 自渲染没有图像 onVideoFrameRender回调函数实现中，y、u、v分量需要按如下方式获取： virtual bool onVideoFrameRender(const char* userId, HRTCVideoFrame& videoFrame){Frame frame;frame.width = videoFrame.width;frame.height = videoFrame.height;frame.yBuf = videoFrame.data;frame.uBuf = videoFrame.data + videoFrame.width * videoFrame.height; //宽*高frame.vBuf = videoFrame.data + videoFrame.width * videoFrame.height * 5 / 4; // 宽*高*5/4frame.yStride = videoFrame.Stride;frame.uStride = videoFrame.Stride / 2;frame.vStrides = videoFrame.Stride / 2;//用frame取渲染窗口return true;} 父主题： All Platform C++ SDK

DR2：亚非拉（新加坡） 国家/地区名（中文全称） 国家/地区名（英文全称） 国家/地区码（英文缩写） 阿联酋 The United Arab Emirates AE 阿富汗 Afghanistan AF 安提瓜和巴布达 Antigua And Barbuda AG 安圭拉 Anguilla AI 亚美尼亚 Armenia AM 安哥拉 Angola AO 南极洲 Antarctica AQ 阿根廷 Argentina AR 美属萨摩亚 American Samoa AS 阿鲁巴 Aruba AW 阿塞拜疆 Azerbaijan AZ 巴巴多斯 Barbados BB 孟加拉 Bengal BD 布基纳法索 Burkina Faso BF 巴林 Bahrain BH 布隆迪 Burundi BI 贝宁 Benin BJ 圣巴泰勒米岛 Saint Barthélemy BL 百慕大 Bermuda BM 文莱 Brunei Darussalam BN 玻利维亚 Bolivia BO 巴西 Brazil BR 巴哈马 The Bahamas BS 不丹 Bhutan BT 布韦岛 Bouvet Island BV 博茨瓦纳 Botswana BW 伯利兹 Belize BZ 科科斯群岛 Cocos (Keeling) Islands CC 刚果金 Congo (Democratic Republic of the) CD 中非 Central African Republic CF 刚果布 Congo CG 科特迪瓦 Côte d'Ivoire CI 库克群岛 Cook Islands CK 智利 Chile CL 喀麦隆 Cameroon CM 哥伦比亚 Colombia CO 哥斯达黎加 Costa Rica CR 佛特角 Cabo Verde CV 圣诞岛 Christmas Island CX 吉布提 Djibouti DJ 多米尼克 Dominica DM 多米尼加 Dominican Republic DO 阿尔及利亚 Algeria DZ 厄瓜多尔 Ecuador EC 埃及 Egypt EG 西撒哈拉 Western Sahara EH 厄尔特里亚 Eritrea ER 埃塞俄比亚 Ethiopia ET 斐济群岛 Fiji FJ 马尔维纳斯群岛（福克兰） Falkland Islands FK 密克罗尼西亚 Micronesia (Federated States of) FM 加蓬 Gabon GA 格林纳达 Grenada GD 格鲁吉亚 Georgia GE 法属圭亚那 French Guiana GF 加纳 Ghana GH 冈比亚 Gambia GM 几内亚 Guinea GN 瓜德罗普 Guadeloupe GP 赤道几内亚 Equatorial Guinea GQ 南乔治亚岛和南桑威奇群岛 South Georgia and the South Sandwich Islands GS 危地马拉 Guatemala GT 关岛 Guam GU 几内亚比绍 Guinea-Bissau GW 圭亚那 Guyana GY 香港 Hong Kong HK 赫德岛和麦克唐纳群岛 Heard Island and McDonald Islands HM 洪都拉斯 Honduras HN 海地 Haiti HT 印度尼西亚 Indonesia ID 印度 India IN 英属印度洋领地 British Indian Ocean Territory IO 伊拉克 Iraq IQ 牙买加 Jamaica JM 约旦 Jordan JO 肯尼亚 Kenya KE 吉尔吉斯斯坦 Kyrgyzstan KG 柬埔寨 Cambodia KH 基里巴斯 Kiribati KI 科摩罗 Comoros KM 圣基茨和尼维斯 Saint Kitts and Nevis KN 科威特 Kuwait KW 开曼群岛 Cayman Islands KY 哈萨克斯坦 Kazakhstan KZ 老挝 Laos LA 黎巴嫩 Lebanon LB 圣卢西亚 Saint Lucia LC 斯里兰卡 Sri Lanka LK 利比里亚 Liberia LR 莱索托 Lesotho LS 利比亚 Libya LY 摩洛哥 Morocco MA 马达加斯加 Madagascar MG 马绍尔群岛 Marshall islands MH 马里 Mali ML 缅甸 Myanmar MM 蒙古 Mongolia MN 澳门 Macao MO 北马里亚纳群岛 Northern Mariana Islands MP 马提尼克 Martinique MQ 毛里塔尼亚 Mauritania MR 蒙特塞拉特岛 Montserrat MS 毛里求斯 Mauritius MU 马尔代夫 Maldives MV 马拉维 Malawi MW 墨西哥 Mexico MX 马来西亚 Malaysia MY 莫桑比克 Mozambique MZ 纳米比亚 Namibia NA 新喀里多尼亚 New Caledonia NC 尼日尔 Niger NE 诺福克岛 Norfolk Island NF 尼日利亚 Nigeria NG 尼加拉瓜 Nicaragua NI 尼泊尔 Nepal NP 瑙鲁 Nauru NR 纽埃 Niue NU 阿曼 Oman OM 巴拿马 Panama PA 秘鲁 Peru PE 法属波利尼西亚 French Polynesia PF 巴布亚新几内亚 Papua New Guinea PG 菲律宾 Philippines PH 巴基斯坦 Pakistan PK 皮特凯恩群岛 Pitcairn PN 波多黎各 Puerto Rico PR 巴勒斯坦 Palestine, State of PS 帕劳 Palau PW 巴拉圭 Paraguay PY 卡塔尔 Qatar QA 留尼汪 Reunion !Réunion RE 卢旺达 Rwanda RW 沙特阿拉伯 Saudi Arabia SA 所罗门群岛 Solomon Islands SB 塞舌尔 Seychelles SC 新加坡 Singapore SG 圣赫勒拿 Saint Helena, Ascension and Tristan da Cunha SH 塞拉利昂 Sierra Leone SL 塞内加尔 Senegal SN 索马里 Somalia SO 苏里南 Suriname SR 南苏丹 South Sudan SS 圣多美和普林西比 Sao Tome and Principe ST 萨尔瓦多 El Salvador SV 斯威士兰 Swaziland SZ 特克斯和凯科斯群岛 Turks and Caicos Islands TC 乍得 Chad TD 法属南部领地 French Southern Territories TF 多哥 Togo TG 泰国 Thailand TH 塔吉克斯坦 Tajikistan TJ 托克劳 Tokelau TK 东帝汶 Timor-Leste TL 土库曼斯坦 Turkmenistan TM 突尼斯 Tunisia TN 汤加 Tonga TO 特立尼达和多巴哥 Trinidad and Tobago TT 图瓦卢 Tuvalu TV 台湾 Taiwan, Province of China TW 坦桑尼亚 Tanzania, United Republic of TZ 乌干达 Uganda UG 乌拉圭 Uruguay UY 乌兹别克斯坦 Uzbekistan UZ 委内瑞拉 Venezuela (Bolivarian Republic of) VE 英属维尔京群岛 Virgin Islands, British VG 美属维尔京群岛 Virgin Islands, U.S. VI 越南 Vietnam VN 瓦努阿图 Vanuatu VU 瓦利斯和富图纳 Wallis and Futuna WF 萨摩亚 Samoa WS 也门 Yemen YE 马约特 Mayotte YT 南非 South Africa ZA 赞比亚 Zambia ZM 津巴布韦 Zimbabwe ZW 古巴 Cuba CU 朝鲜 North Korea KP 苏丹 Sudan SD 叙利亚 Syria SY 日本 Japan JP 韩国 Korea (Republic of) KR

服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在 程序或环境问题 RTC.31000001 session校验失败 程序或环境问题 RTC.31000003 内部异常 程序或环境问题 RTC.31000004 认证失败 用户使用问题 RTC.31000005 请重试 用户使用问题 RTC.31000006 需要时钟同步 用户使用问题 RTC.31000007 请求资源不存在 程序或环境问题 RTC.32000000 服务异常 程序或环境问题 RTC.32000001 流号已满 程序或环境问题 RTC.32000002 SFU为空 程序或环境问题 RTC.32000004 下发流信息失败 程序或环境问题 RTC.32000005 添加适配器失败 程序或环境问题 RTC.32000006 添加路由失败 程序或环境问题 RTC.32000007 获取用户信息异常 程序或环境问题 RTC.32000010 选看用户不存在 程序或环境问题 RTC.32000011 音频速率参数非法 程序或环境问题 RTC.32000012 用户列表为空 程序或环境问题 RTC.32000013 非法请求参数 程序或环境问题 RTC.32000015 内部调用异常 程序或环境问题 RTC.32000016 内部调用异常 程序或环境问题 RTC.32000017 站点不存在 程序或环境问题 RTC.32000018 错误的加密算法 程序或环境问题 RTC.32000019 客户端媒体加密密钥base64解码失败 程序或环境问题 RTC.32000020 生成媒体加密密钥失败 程序或环境问题 RTC.32000021 下发加密信息异常 程序或环境问题 RTC.32000022 获取SFU的IP失败 程序或环境问题 RTC.32000024 内部调用异常 程序或环境问题 RTC.32000025 内部调用异常 程序或环境问题 RTC.32000028 不支持的操作 程序或环境问题 RTC.32000030 sfu资源不足 程序或环境问题 RTC.32000032 跨房数量超过上限 用户使用问题 RTC.32000033 不允许重复跨入同一房间 用户使用问题 RTC.32000034 稍后重试 程序或环境问题 RTC.33000000 服务异常 程序或环境问题 RTC.33000001 节点不存在 程序或环境问题 RTC.34000001 房间已满 用户使用问题 RTC.34000002 房间不存在 程序或环境问题 RTC.34000003 站点不存在 程序或环境问题 RTC.34000004 内部调用异常 程序或环境问题 RTC.34000006 用户不存在 用户使用问题 RTC.34000007 已存在辅流共享 用户使用问题 RTC.200001 请求参数不正确 用户使用问题 RTC.200030 没有可用的mcu资源 云测问题 RTC.200031 创建推流任务失败 云测问题 RTC.200032 混流任务已存在 用户使用问题 RTC.200033 混流任务不存在 用户使用问题 RTC.200034 参与混流的用户为空 用户使用问题 父主题： 接口参考

onAudioFramePlayback virtual bool onAudioFramePlayback(HRTCAudioFrame& audioFrame) 【功能说明】 需要播放的音频数据回调，从接口回调中取到音频数据以作后处理。 【回调参数】 audioFrame：音频数据格式 ，具体请参见HRTCAudioFrame。 【返回参数】 true：处理结果成功。 false：处理结果失败。

修订记录 表1 修订记录 修改时间 修改说明 2022-06-21 第六次正式发布 本次变更如下： 新增以下接口： addMultiRoomMediaRelay：添加单个跨房 removeMultiRoomMediaRelay：删除单个跨房 stopMultiRoomMediaRelay：停止所有跨房 onMultiRoomMediaRelayStateChanged：跨房状态回调 appendLocalView：设置本地视频另一个窗口显示 appendRemoteView：设置远端视频另一个窗口显示 新增以下事件回调： onRenderExternalVideoFrame：视频自渲染回调 onPlaybackExternalAudioFrame：音频自渲染回调 onMultiRoomMediaRelayStateChanged：跨房状态改变回调 onRemoteMicrophoneStateChanged：麦克风设备状态变更通知 onUserNetworkQualityNotify：加入房间后的网络质量状态回调 新增以下数据类型： HWRtcRemoteMicState：麦克风设备状态 HRTCMultiRoomMediaRelayConfiguration：跨房配置 HRT CS rcMultiRoomMediaInfo：源房间信息 HRTCDstMultiRoomMediaInfo：目标房间信息 HRTCMultiRoomMediaRelayState：跨房状态 HRTCMultiRoomMediaRelayStateCode：跨房状态码 2022-03-24 第五次正式发布 本次变更如下： 修改appid获取方式的相关描述。 2022-03-18 第四次正式发布 本次变更如下： 新增setNetworkBandwidth接口 2022-02-25 第三次正式发布 本次变更如下： 新增以下接口： recordingDeviceTest音频采集设备测试 finishRecordingDeviceTest结束音频采集设备测试 playbackDeviceTest音频播放设备测试 finishPlaybackDeviceTest结束音频播放设备测试 echoTest音频设备回路测试 finishEchoTest结束音频设备回路测试 cameraDeviceTest视频采集设备测试 finishCameraDeviceTest结束视频采集设备测试 onAudioDeviceTestVolumeNotify音频设备测试回调 setVideoWaterMark插入/删除水印 setAccessResourceType设置接入环境 setBackgroungBlur设置本地视频背景虚化 setBackgroundReplace设置本地视频背景替换 修改以下接口： HRTCVideoDisplayMode去掉自适应HRTC_VIDEO_DISPLAY_MODE_ADAPT 2021-12-02 第二次正式发布 本次变更如下： 优化部分文档描述。 2021-11-22 第一次正式发布 父主题： All Platform C++ SDK

点播消息订阅的主题在哪里设置？具体怎么配置消息订阅功能？ 由于点播的消息订阅功能是通过 SMN 实现的，因此需要先在SMN控制台中配置消息主题和策略，用于消息发送和订阅通知，并授权点播服务可对该主题发布消息。然后在点播控制台中配置消息订阅，即可在转码、截图、审核等操作时接收到 消息通知 。具体操作详情请参见消息订阅。 添加消息主题订阅后，配置的订阅终端将收到确认订阅消息，您需要在终端单击“订阅确认”，确认后，设置的订阅终端才能收到该主题发布的消息。 父主题： 消息订阅

点播服务是否支持转码回调？ 支持， 视频点播 通过消息通知服务SMN实现转码完成事件通知。在进行音视频转码前，您可以先配置消息订阅，配置完后，即可在转码完成后收到消息通知。 支持接收如下两种消息类型： 模板消息：若消息类型“模板消息”和“json消息”都选择，则对于“短信”以及“邮件”订阅协议，只能接收到模板消息，对于“HTTP”以及“HTTPS”订阅协议，只能接收到json消息。 表1 模板消息说明 事件处理 通知文本消息内容 转码成功 尊敬的用户，您的视频转码任务已成功完成。视频ID：{asset_id}，名称：{title}，请登录点播Console或调用点播API获取详细转码信息。 转码失败 尊敬的用户，您的视频转码任务处理时出现错误。视频ID：{asset_id}，名称：{title}，错误码：{err_code}，错误信息：{err_msg}。 json消息：具体消息体及说明请参见转码消息体。 父主题： 音视频处理问题

为什么流量包中的流量使用量与数据分析中的流量显示存在差别？ 以下两种情况会导致流量包使用量和数据分析中不一致： 数据分析中展示的流量存在一个小时左右的延时。而账单扣费存在四小时左右的延时，因此，扣费时间晚于数据分析，从而导致数据分析中流量多于当前流量包扣除的流量。 示例：12:00-13:00产生分发流量20M 流量包扣费时间：12:00-13:00产生的流量将在17:00产生账单，扣除20M流量。 数据分析时间：12:00-13:00产生的流量会在14:00时在数据分析页面增加20M流量。 所以在14:00时数据分析页面已经统计了这20M流量，而流量包还未扣除，所以二者不一致。 按流量计费未购买流量包的用户同样存在已扣费用和数据分析中不一致的情况，也是因为扣费延迟导致。 数据分析页面展示的是加速 域名 日志中记录的流量数据，是应用层日志统计出的流量，但是实际产生的网络流量由于TCP/IP包头消耗和TCP重传消耗要比应用层统计到的流量高出7%~15%。因此按照业界标准，应用于账单的计费数据会在控制台监控数据的基础上上浮10%。所以会导致流量包中使用的流量高于数据分析中的流量显示。 父主题： 购买计费

视频点播是否有内置系统模板？ 为了方便用户快捷使用转码功能，视频点播内置了一些常见的视频画质的视频转码模板及转封装模板，如表1所示。具体请参见转码设置。 表1 系统模板 名称 说明 适应场景 non_transcoding_template_group 不转码模板组。 适用于不需要转码处理的场景。 system_template_group 视频转码模板组，内置了4k、2k、超清、高清、标清、流畅六种清晰度。 适用于不清楚如何设置分辨率宽高和码率的场景，该模板支持快捷选择画质、格式、水印等。 original_temate_group 转封装格式组，只改变音视频文件的封装格式。 适用于不需要修改音视频文件的宽高和码率的场景。 adaptive_template_group 视频自适应模板组，可编辑模板分辨率及码率。 适用于需要视频转码的同时，还需要画质增强的场景。 父主题： 音视频处理问题

为什么上传音视频后，无法获取到音视频的时长？ 上传媒资后无法获取时长，可能是如下原因： 上传的媒资文件解析未完成：点播服务需要解析上传的音视频后，才能返回音视频时长，所以建议您在上传视频5分钟后再进行视频时长的获取。 上传的媒资文件不满足编码格式要求：建议您检查上传的媒资文件是否满足编码格式要求，若存在不满足编码格式要求的媒资文件，建议删除，再重新上传。 支持上传的音视频文件编码格式如下所示： 支持的视频编码格式：H.263、H.264、 H.265、MPEG-2、MPEG-4、MJPEG、ProRes 422。 支持的音频编码格式：AAC、 AC3、EAC3、HE-AAC、MP2、MP3、PCM（s161e、s16be、s241e、s24be、dvd）、WMA。 在播放器中播放不显示视频时长：建议您更换播放器进行测试，或者进行转码处理。 父主题： 上传问题