华为云用户手册

请求参数 参数 是否必选 参数类型 描述 os-reinstall 是 Object 标记为重装裸金属服务器操作。详情请参见表2。 表2 os-reinstall字段数据结构说明 参数 是否必选 参数类型 描述 adminpass 否 String 裸金属服务器管理员账号的初始登录密码。 其中，Linux管理员账户为root，Windows管理员账户为Administrator。 建议密码复杂度如下： 长度为8-26位。 密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。 密码不能包含用户名或用户名的逆序。 说明： 对于Windows裸金属服务器，不能包含用户名中超过两个连续字符的部分。 对于Linux裸金属服务器也可使用user_data字段实现密码注入，此时adminpass字段无效。 adminpass和keyname不能同时有值。 adminpass和keyname如果同时为空，此时，metadata中的user_data属性必须有值。 keyname 否 String 密钥名称。 密钥可以通过创建和导入SSH密钥（OpenStack原生）API创建，或者使用查询SSH密钥列表（OpenStack原生）API查询已有的密钥。 userid 否 String 用户ID（登录管理控制台，进入我的凭证，即可看到“用户ID”）。 metadata 否 Object 重装裸金属服务器的元数据。详情请参见表3。 表3 metadata字段数据结构说明 参数 是否必选 参数类型 描述 user_data 否 String 重装裸金属服务器过程中待注入的Linux镜像root密码，用户自定义初始化密码。 注：修改密码脚本需经base64编码。 建议密码复杂度如下： 长度为8-26位。 密码至少必须包含大写字母（A-Z）、小写字母（a-z）、数字（0-9）和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。 示例： 1 2 #!/bin/bash echo 'root:$6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig/GpOkLcOhab9smJoLKYm/Tf9Hcwa6DpiPDhdHfGEAPajFmLZa0YDd910' | chpasswd -e 此脚本需经base64编码方式编码。 其中，$6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig为密文密码，生成方法如下： 生成加密盐值 1 2 [root@test linux]# python -c "import crypt, getpass, pwd;print crypt.mksalt()" $6$V6azyeLwcD3CHlpY 根据盐值生成密文密码 1 2 [root@test linux]# python -c "import crypt, getpass, pwd;print crypt.crypt('Cloud.1234','\$6\$V6azyeLwcD3CHlpY')" $6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig/GpOkLcOhab9smJoLKYm/Tf9Hcwa6DpiPDhdHfGEAPajFmLZa0YDd910 密文生成之后，修改密码脚本需经base64编码方式编码。

URI POST /v1/{project_id}/baremetalservers/{server_id}/reinstallos 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（OpenStack原生）获取。

URI GET /v1/{project_id}/baremetalservers/{server_id}/os-server-password 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（OpenStack原生）获取。

接口总览 本章节介绍了Android SDK的HRTCConnection接口详情。 HRTCConnection按照其功能可分类为：初始化等基础接口、房间功能、音频管理、视频管理、屏幕共享。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。 表1 初始化等基础接口 接口 描述 release 释放Connection setEncryption 设置端到端加密模式 setNetworkBandwidth 设置网络带宽限制 表2 房间功能接口 接口 描述 joinRoom 加入房间 leaveRoom 离开房间 getRoomId 获取房间id renewAuthorization 更新签名 changeUserRole 切换角色 changeUserName 修改用户昵称 表3 视频管理接口 接口 描述 setPriorRemoteVideoStreamType 设置优先选看档位 pullRemoteVideo 订阅或取消订阅远端用户 setupRemoteView 设置远端用户窗口 startRemoteStreamView 按档位选看远端用户，并设置用户窗口 stopRemoteStreamView 取消订阅远端用户，并清除此用户的窗口 pullAllRemoteVideo 订阅或取消订阅全部远端用户，对未入会用户也有影响 setRemoteVideoStreamType 切换用户指定档位的视频 updateRemoteRenderMode 设置远端视频渲染模式，镜像模式 setRemoteVideoAdjustResolution 远端流自动调整分辨率开关 startAllRemoteView 批量设置远端流视图 表4 音频管理接口 接口 描述 muteRemoteAudio 远端用户静音开关 muteAllRemoteAudio 所有远端用户静音开关 adjustPlaybackVolume 调整单个用户播放音量 表5 自定义渲染接口 接口 描述 setExternalAudioFrameOutputEnable 音频流第三方播放开关（音频自渲染） setExternalVideoFrameOutputEnable 视频流第三方渲染开关（视频自渲染） setExternalDataFrameOutputEnable 辅流第三方渲染开关（辅流自渲染） 表6 辅流管理接口 接口 描述 startRemoteAuxiliaryStreamView 订阅远端用户辅流，并设置窗口 stopRemoteAuxiliaryStreamView 取消订阅远端用户辅流，并清除用户窗口 updateRemoteAuxiliaryStreamRenderMode 设置辅流渲染填充方式，镜像模式 setRemoteAuxiliaryStreamViewRotation 设置辅流旋转角度 父主题： HRTCConnection

基本使用逻辑 创建新的项目工程，导入 SDK 后，需要创建客户端并获取本地音视频设备信息。 创建本地流并初始化。 当用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以对音视频流进行订阅、取消订阅等其它操作。 在会中，也可以对本地录音或播放设备等进行配置。 用户离开房间后，房间内其他用户会收到该用户离开的回调信息，离开房间后，需销毁对应资源。 在时序图中，单击相应接口名称可快速跳转到相应接口位置查看其使用方法。 父主题： Web SDK

设备管理 表11 设备管理接口 接口 描述 setSpeakerModel 设置声音播放模式（只支持iphone） setCameraConfig 设置摄像头相关参数 switchCamera 切换前后镜头（只支持iphone） recordingDeviceTest 音频采集设备测试（只支持macOS） finishRecordingDeviceTest 结束音频采集设备测试（只支持macOS） playbackDeviceTest 音频播放设备测试（只支持macOS） finishPlaybackDeviceTest 结束音频播放设备测试（只支持macOS） echoTest 音频设备回路测试（只支持macOS） finishEchoTest 结束音频设备回路测试（只支持macOS） cameraDeviceTest 视频采集设备测试 finishCameraDeviceTest 结束视频采集设备测试

音效文件播放管理 表7 音频文件播放管理接口 接口 描述 startAudioFile 开始播放音频文件 stopAudioFile 停止播放音频文件 pauseAudioFile 暂停播放音频文件 resumeAudioFile 恢复播放音频文件 adjustAudioFileVolume 调节音频文件播放音量 adjustAudioFilePlayoutVolume 设置本地播放音频音量 getAudioFileVolume 获取音频文件播放音量 getAudioFilePlayoutVolume 获取音频文件本地播放音量 getAudioFileDuration 获取音频文件时长 getAudioFileCurrentPosition 获取当前音频播放位置 setAudioFilePosition 设置音频播放位置 getAudioClipsVolume 获取音效总音量 getVolumeOfAudioClip 获取指定音效音量 setAudioClipsVolume 设置音效总音量 setVolumeOfAudioClip 设置指定音效音量 playAudioClip 播放音效文件 stopAudioClip 停止播放指定音效 stopAllAudioClips 停止播放所有音效 pauseAudioClip 暂停播放指定音效 pauseAllAudioClips 暂停播放所有音效 resumeAudioClip 恢复播放指定音效 resumeAllAudioClips 恢复播放所有音效 getAudioClipCurrentPosition 获取指定音效当前播放位置 setAudioClipPosition 设置指定音效播放位置 getAudioClipDuration 获取音效文件时长

自定义视频采集和渲染 表10 自定义视频采集和渲染接口 接口 描述 setExternalVideoCapture 设置是否开启外部视频采集 pushExternalVideoFrame 输入外部视频数据 setExternalMediaFrameOutput 设置媒体数据自渲染 setExternalVideoFrameOutputWithFormat 带Format参数设置媒体数据自渲染 pushAuxExternalVideoFrame 辅流输入外部视频数据

辅流管理 表5 辅流管理接口 接口 描述 startRemoteAuxiliaryStreamView 开启辅流渲染视图（发起辅流选看） stopRemoteAuxiliaryStreamView 关闭辅流渲染视图（停止辅流选看） updateRemoteAuxiliaryStreamRenderMode 设置辅流视图渲染模式，镜像模式 setRemoteAuxiliaryStreamViewRotation 设置辅流视图角度 setAuxiliaryVideoEncoderConfig 设置辅流编码能力 setAuxiliaryVideoEncodeSmooth 设置是否开启辅流的流畅度优先 pushAuxExternalVideoFrame 推送辅流数据

视频管理 表4 视频管理接口 接口 描述 enableLocalVideo 设置是否开启摄像头采集视频 setVideoEncoderConfig 设置视频编码参数 enableSmallVideoStream 大小流模式设置是否开启小流并设置小流编码参数 startLocalPreview 开启本地预览 stopLocalPreview 关闭本地预览 setupLocalVideo 设置/取消本地预览视图 updateLocalRenderMode 设置本地视频显示模式和镜像模式 setupRemoteView 设置远端流视图 updateRemoteRenderMode 设置远端视图显示模式，镜像模式 setRemoteVideoStreamType 设置选看指定用户的大流或者小流 setPriorRemoteVideoStreamType 设置默认选看远端的大流或者小流 pushLocalVideo 设置是否发送本地视频流 pullRemoteVideo 订阅或取消订阅远端某个用户视频流 pullAllRemoteVideo 订阅或取消订阅全部远端用户视频流 startRemoteStreamView 设置远端用户渲染视图（发起选看-旧接口） stopRemoteStreamView 关闭远端用户的渲染视图（停止选看） setRemoteVideoAdjustResolution 设置远端下行视频流的分辨率自适应 setVideoEncoderMirror 设置视频编码镜像模式 startPublishStream 开始旁路推流 updateTransCoding 更新旁路推流 stopPublishStream 停止旁路推流 startAllRemoteView 批量设置远端流视图 appendLocalView 设置本地视频另一个窗口显示 appendRemoteView 设置远端视频另一个窗口显示

音频管理 表3 音频管理接口 接口 描述 muteLocalAudio 设置是否发送本地音频流 enableLocalAudioStream 设置是否开启麦克风采集音频 muteRemoteAudio 订阅或取消订阅远端某个用户音频流 muteAllRemoteAudio 订阅或取消订阅全部远端用户音频流 setVolumeNotifyInterval 设置最大音量上报频率 adjustRecordingVolume 设置麦克风采集的音量（0-100） adjustPlaybackVolume 调整扬声器播放的音量（0-100） setShareComputerSound 共享声音 (只支持macOS) sendAudioSeiMsg 发送音频SEI消息 setDefaultSpeakerModel 设置默认的声音播放模式，在房间外调用 setAudioFrameRecordParameters 设置音频采集回调参数 setAudioConfig 设置音频场景

房间功能 表2 房间功能接口 接口 描述 joinRoom 加入房间 changeUserRole 设置用户的角色，角色切换时使用 renewAuthorization 签名更新 leaveRoom 离开房间 changeUserName 设置用户自己的昵称 createConnection 创建 跨房（HWRtcConnection）对象，跨房前需先创建连接 addMultiRoomMediaRelay 添加单个跨房 removeMultiRoomMediaRelay 删除单个跨房 stopMultiRoomMediaRelay 停止所有跨房

初始化等基础接口 表1 初始化等基础接口 接口 描述 sharedEngine 创建连麦引擎实例 destroy 注销引擎 initWithConfig 初始化引擎配置信息 logUpload 上传日志 setEnableRtcStats 打点开关 getVersion 获取SDK版本号 setEncrytionParam 设置端到端加密模式 setAccessResourceType 设置接入的环境 setNetworkBandwidth 设置网络带宽限制

视频管理 表3 视频管理接口 接口 描述 setupRemoteView 设置远端流渲染视图 updateRemoteRenderMode 设置远端用户视图渲染模式,镜像模式 setRemoteVideoStreamType 大小流模式，设置远端视频流类型 setPriorRemoteVideoStreamType 大小流模式，设置所有订阅的远端视频流类型 pullRemoteVideo 设置是否接收对应远端用户的视频流 pullAllRemoteVideo 设置是否接收所有用户的视频流 startRemoteStreamView 设置远端用户渲染视图（发起选看-老接口） stopRemoteStreamView 关闭远端用户的渲染视图 setRemoteVideoAdjustResolution 设置是否开启远端分辨率自适应

辅流管理 表5 辅流管理接口 接口 描述 setRemoteAuxiliaryStreamViewRotation 设置远端辅流视图旋转角度 startRemoteAuxiliaryStreamView 开启辅流渲染视图（发起辅流选看） stopRemoteAuxiliaryStreamView 关闭辅流渲染视图（停止辅流选看） updateRemoteAuxiliaryStreamRenderMode 设置辅流视图显示模式，镜像模式 setRemoteAuxiliaryStreamViewOrientation 设置远端辅流视图方向（横竖屏）

onMediaConnectStateChangedNotify void onMediaConnectStateChangedNotify(HRTCConnection conn, HRTCMediaConnStateTypes state, HRTCMediaConnChangeReason reason, String description); 【功能说明】 媒体服务器连接状态变更通知。加入房间过后，收到媒体服务的数据包时，返回Connected消息，超过6s没有收到包，则返回Failed消息。 【回调参数】 conn：回调对应的HRTCConnection实例。 state：连接状态，具体请参见HRTCMediaConnStateTypes。 reason：连接状态变化的原因，具体请参见HRTCMediaConnChangeReason。 description：连接状态变化原因描述。

onRemoteShareStatusChangeNotify void onRemoteShareStatusChangeNotify(HRTCConnection conn, String userId, boolean isRecving) 【功能说明】 上报下行辅流状态变化通知，接收端探测网络变化，分配给下行辅流，如果有辅流因为带宽不足被停掉或者带宽恢复而恢复，则上报给产品。 【回调参数】 conn: 连接对象。 userId：下行辅流对应的用户ID。 isRecving：是否接受。

onFirstRemoteAuxiliaryStreamDecoded void onFirstRemoteAuxiliaryStreamDecoded(HRTCConnection conn, String roomId, String userId, int width, int height); 【功能说明】 接收到第一帧远端辅流并解码成功，触发此回调。 【回调参数】 conn：回调对应的HRTCConnection实例。 roomId：视频流对应的房间ID。 userId：视频流对应的用户ID。 width：视频流宽。 height：视频流高。

onUserNameChangedNotify void onUserNameChangedNotify(HRTCConnection conn, String oldUserName, String newUserName); 【功能说明】 调用changeUserName接口成功后，上报此事件通知修改昵称结果。 【回调参数】 conn：回调对应的HRTCConnection实例。 oldUserName：修改前的昵称。 newUserName：修改后的昵称。

onTopActiveSpeaker public void onTopActiveSpeaker(String userId); 【功能说明】 上报当前最活跃的用户userId。该回调主要用于0号会场场景（额外订阅uid为0的用户音频）。 【回调参数】 userId：返回当前远端音量最活跃的用户ID。 0号会场模式下，SDK会持续监测（根据一定时间内用户音量大小）当前最活跃的用户，如果最活跃用户发生变化，则触发此回调并上报当前最活跃的用户userId。

onVideoResolutionChangedNotify void onVideoResolutionChangedNotify(HRTCConnection conn, String userid, int width, int height); 【功能说明】 远端视频大小改变回调。 【回调参数】 conn：回调对应的HRTCConnection实例。 userId：用户ID。 width：视频流宽度。 height：视频流高度。

onFirstRemoteVideoDecoded void onFirstRemoteVideoDecoded(HRTCConnection conn, String userId, int width, int height); 【功能说明】 远端用户第一帧解码成功回调。 【回调参数】 conn：回调对应的HRTCConnection实例。 userId：用户ID。 width：视频宽度。 height：视频高度。

onRenderSuccessNotify void onRenderSuccessNotify(HRTCConnection conn, String userId, boolean isAux); 【功能说明】 用户视频流渲染成功通知回调。首帧渲染成功、分辨率变化或视频流中断后恢复触发。 【回调参数】 conn：回调对应的HRTCConnection实例。 userId：用户ID。 isAux：是否辅流。true为是辅流，false为不是辅流。

onRemoteUserNameChangedNotify void onRemoteUserNameChangedNotify(HRTCConnection conn, String userId, String userName); 【功能说明】 远端用户修改昵称后，通知本端昵称变更。 【回调参数】 conn：回调对应的HRTCConnection实例。 userId：修改昵称的用户id。 userName：修改后的昵称。

onRemoteVideoStateChangedNotify void onRemoteVideoStateChangedNotify(HRTCConnection conn, String userId, HRTCRemoteVideoStreamState state, HRTCRemoteVideoStreamStateReason reason); 【功能说明】 远端视频流状态变化回调。 【回调参数】 conn：回调对应的HRTCConnection实例。 userId：远端用户ID。 state：远端视频流状态，具体请参见HRTCRemoteVideoStreamState。 reason：远端视频流状态变化原因，具体请参见HRTCRemoteVideoStreamStateReason。

onStreamPublishStateChange void onStreamPublishStateChange(HRTCConnection conn,int code, const char* taskId, const HRTCUrlStatusList * urlStatus); 【功能说明】 RTMP推流状态回调。 【回调参数】 conn：回调对应的HRTCConnection实例。 code：错误码，0表示成功，非0请参见错误码。 taskId：任务Id。 urlStatus：推流的url结果结构体，具体请参见HRTCUrlStatusList。

onUserAuxiliaryStreamAvailable void onUserAuxiliaryStreamAvailable(HRTCConnection conn, String userId, boolean available); 【功能说明】 辅流加入房间。 【回调参数】 conn：回调对应的HRTCConnection实例。 userId：用户ID。 available：true为辅流开始推送，false为辅流停止推送。

onRemoteAudioStateChangedNotify void onRemoteAudioStateChangedNotify(HRTCConnection conn, String userId, HRTCRemoteAudioStreamState state, HRTCRemoteAudioStreamStateReason reason); 【功能说明】 远端音频流状态变化回调。 【回调参数】 conn：回调对应的HRTCConnection实例。 userId：远端用户ID。 state：远端音频流状态，具体请参见HRTCRemoteAudioStreamState。 reason：远端音频流状态变化原因，具体请参见HRTCRemoteAudioStreamStateReason。

onLeaveRoom void onLeaveRoom(HRTCConnection conn, HRTCLeaveReason reason, HRTCStatsInfo statsInfo); 【功能说明】 离开房间回调。 【回调参数】 conn：回调对应的HRTCConnection实例。 reason：自己离开房间的原因，具体请参见HRTCLeaveReason。 statsInfo：会议期间的统计信息，具体请参见HRTCStatsInfo。

onConnectionChangedNotify void onConnectionChangedNotify(HRTCConnection conn, HRTCConnStateTypes connStateTypes, HRTCConnChangeReason connChangeReason, String description); 【功能说明】 网络连接状态改变。 【回调参数】 conn：回调对应的HRTCConnection实例。 connStateTypes：网络连接状态，具体请参见HRTCConnStateTypes。 connChangeReason：网络连接状态原因，具体请参见HRTCConnChangeReason。 description：描述。