华为云用户手册

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 unprocessed_opers Array of table_oper_ids objects 未处理的操作列表。 表8 table_oper_ids 参数 参数类型 描述 table_name String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ kv_oper_ids kv_oper_ids object kv操作数组。 表9 kv_oper_ids 参数 参数类型 描述 put_kv_ids Array of integers 上传kv操作, "oper_id"数组。 数组元素：请求内的操作编码，未成功的操作返回该标识。 delete_kv_ids Array of integers 请求内的操作编码，未成功的操作返回该标识。 数组元素：请求内的操作编码，未成功的操作返回该标识。

URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

操作步骤 登录华为云控制台，在左上角的服务列表中选择“”，进入 DataArts Studio 实例控制台。 如果当前区域下有多个DataArts Studio实例，则默认进入实例列表。请单击所需实例卡片上的“进入控制台”，进入DataArts Studio控制台首页。 图1 实例列表 如果当前区域下仅有一个DataArts Studio实例，则默认进入DataArts Studio控制台首页。 DataArts Studio新版控制台首页已经上线，您可以通过单击页面上方banner中的“立即体验”进入。 新版控制台首页，从功能组件入口升级为集任务处理、资源监控和场景学习于一体的一站式数据工作台，全面为您提升生产效率。 图2 旧版控制台首页 图3 新版控制台首页

示例说明 以使用MD5算法为例： 回源请求对象： http://hwcdn.example.com/T128_2_1_0_sdk/0210/M00/82/3E/test.mp3 密钥设为：huaweicloud12345（用户自行设置） 用户访问客户源服务器时间为：201706301000（格式为：YYYYMMDDHHMM） CDN服务器构造一个用于计算md5hash的签名字符串： huaweicloud12345201706301000/T128_2_1_0_sdk/0210/M00/82/3E/test.mp3 CDN服务器根据该签名字符串计算md5hash： md5hash = md5sum("huaweicloud12345201706301000/T128_2_1_0_sdk/0210/M00/82/3E/test.mp3") =668f28d134ec6446a8ae83a43d0a554b 请求CDN时URL： http://hwcdn.example.com/201706301000/668f28d134ec6446a8ae83a43d0a554b/T128_2_1_0_sdk/0210/M00/82/3E/test.mp3 如果请求在有效时间内(请求时间小于等于2017年6月30日10：30：00)，并且计算出来的md5hash与用户请求中带的md5hash值（668f28d134ec6446a8ae83a43d0a554b）一致，则鉴权通过。

校验方法 CDN服务器收到请求后，会按照如下步骤进行校验： 是否携带鉴权参数。如果没有携带鉴权参数，认为请求非法，返回HTTP 403错误。 时间校验：CDN服务器接收到客户端请求后，判断鉴权URL中的“timestamp参数 + 鉴权URL有效时长”是否大于当前时间。 如果“timestamp参数 + 鉴权URL有效时长”小于当前时间，认为过期失效并返回HTTP 403错误。 如果“timestamp参数 + 鉴权URL有效时长”大于或等于当前时间，则通过时间校验，继续执行步骤3。 加密串校验：时间校验通过后，则以sstring方式构造出一个字符串（参考以下sstring构造方式）。然后使用md5（sha256）算法算出HashValue，并和用户请求中带来的md5hash（sha256）进行对比。结果一致则认为鉴权通过并返回文件，否则鉴权失败返回HTTP 403错误。HashValue计算方式如下： sstring = “PrivateKeytimestampFilename” HashValue = sha256sum(sstring) 或： sstring = “PrivateKeytimestampFilename” HashValue = md5sum(sstring)

WSA计费说明 WSA采用基础费用+增值服务费用的方式收取，计费方式详见表1，具体收费标准请参见价格详情。 开通WSA服务后，全站加速 域名 产生的费用由WSA服务收取，CDN和WSA资源包不能相互抵扣。 表1 WSA计费方式 计费项 计费方式 描述 基础服务计费 流量计费 按照每小时实际使用的流量进行计费，也可以购买流量包抵扣使用的流量。 峰值带宽计费 按照每日峰值带宽进行计费，系统每5分钟统计1个峰值带宽，每日得到288个值，取其中的最大值作为计费带宽。 月结95峰值带宽计费 在一个自然月内，将每个有效日的所有峰值带宽的统计点进行排序，去掉数值最高的5%的统计点，取剩下的数值最高统计点为计费点，再根据合同约定的单价计费。 日峰值月平均计费 在一个自然月内，对所有有效日的最大峰值带宽求和取平均，获得当月的计费带宽，再根据合同约定的单价计费。 增值服务计费 全站加速请求数 全站加速的动态请求数和静态请求数计费。

什么是华为云WSA 全站加速（Whole Site Acceleration）适用于各行业动静态内容混合、含较多动态资源请求（如asp、jsp、php等格式的文件）的源站应用服务。通过智能网络加速技术及优质的全线路、跨区域覆盖网络，优化客户在动静态混合、纯动态站点/APP、内容上传、API调用、四层协议传输、跨区域传输等场景下网络传输的成本、性能、稳定性、安全性，提高访问成功率，实现网站整体加速与实时优化。 了解更多全站加速详情请见全站加速WSA。 图1 全站加速请求示意图

CDN支持添加泛域名作为加速域名吗？ CDN支持添加泛域名作为加速域名。“泛域名”是指利用通配符“*”来做次级域名，以实现所有的次级域名均指向同一IP地址。如您在CDN添加泛域名*.test.com作为加速域名，并将*.test.com解析至CDN生成的CNAME域名后，那么您所有*.test.com的次级域名（如a.test.com）都将默认支持 CDN加速 。泛域名（*.test.com）的三级域名（如b.a.test.com）则不会被CDN加速。 泛域名添加规则如下： A账号添加泛域名后，其他账号不能再添加该泛域名的一级域名下所有次级域名。 泛域名的所有次级域名的加速都会产生费用，泛域名有多个次级域名时，CDN统计时将泛域名的产生的流量做汇总，不提供单个次级域名的计费数据。

如何同时部署CDN和WAF（ Web应用防火墙 ） 先将域名解析到CDN，再将CDN加速域名的源站修改为WAF的“CNAME”，这样流量才会被CDN转发到WAF，WAF再将流量转到源站，实现网站流量检测和攻击拦截。配置完成后，流量会先经过CDN，再转发至WAF，实现联动防御。 同时，为了防止其他用户提前将您的域名配置到Web应用防火墙上，从而对您的域名防护造成干扰，建议您到DNS服务商处添加一条WAF的子域名和TXT记录。 配置详情请参考同时部署CDN和WAF的配置指导。

网站负责人联系方式不准确 整改通知： 联系方式失效、联系方式未核实。 可能原因： 已备案网站负责人联系方式经拨打存在空号、停机、关机、无法接通等异常情况，可能是由于网站负责人联系方式变更。 整改建议： 1、请参考变更备案，填写新的互联网信息负责人联系方式，并保持电话畅通。 2、请注意接听备案核验电话，或拨打950808转5主动申请核验。若联系方式已变更请提交变更备案修改联系方式 父主题： 互联网信息不准确

未悬挂备案号或备案号未链接至工信部 整改通知一： 网站备案号未链接工信部网站。 可能原因： 悬挂的备案号未链接工信部。 整改建议： 请悬挂正确的网站备案号。悬挂的备案号需链接至工信部网址：beian.miit.gov.cn 整改通知二： 已备案网站底部未悬挂或悬挂错误的网站备案号。 可能原因： 网站底部未悬挂备案号、备案号悬挂有误或悬挂的备案号。 整改建议： 请悬挂正确的网站备案号。且悬挂的备案号需链接至工信部网址：beian.miit.gov.cn 整改通知三： 公安备案号未悬挂或悬挂错误。 可能原因： 未悬挂公安备案号或悬挂的公安备案号不正确。 整改建议： 悬挂正确的公安备案号，与完成公安备案后取得的网站备案号保持一致。 父主题： 网站内容不合格

前置审批不合格 驳回原因一： 网站内容涉及前置审批内容，请提供相关证件。 网站内容涉及需前置审批行业的内容，但备案时未提供前置审批文件。 修改措施： 若网站内容涉及需前置审批行业的内容，请先到相关批复单位办理前置审批，并在备案信息中输入审批号和上传审批文件。具体操作请参见前置审批。 驳回原因二： 前置审批文件过期或上传的前置审批文件不清晰、不完整。 修改措施： 前置审批文件过期需重新办理，且要求上传清晰、完整的资料图片。 父主题： 备案审核驳回FAQ

获取备案授权码 使用华为云账号登录备案系统 。 单击左侧导航栏的“授权码管理”，进入“备案授权码”界面。 图1 备案授权码界面 单击右上角“生成授权码”，在“生成授权码”窗口中选择云服务和IP，用于生成授权码。 选择云服务：请选择一台包月3个月及以上的云服务器资源。 选择IP：请选择弹性公网IP资源。 选择云服务时，对于不满足要求的资源，系统将自动置灰，无法选择。如： 云服务器的计费模式为“按需计费”，如需使用，请变更为“包年/包月”方式。 云服务器的包周期时长不足，需至少包月3个月及以上。 当前云服务器资源已用于生成授权码，不能重复使用。 图2 生成授权码 根据备案需要选择生成授权码的数量。 图3 选择数量 单击“确定”，生成备案授权码。

使用备案授权码 登录备案系统 登。 根据界面提示，在“产品验证”页面，输入如下信息： 云服务类型：选择“备案授权码”。 备案授权码：输入具体的备案授权码。系统不会自动填充您的备案授权码，请复制后粘贴，或手动输入。 一个华为云账号只能为一个主体办理备案，如需使用同一台服务器为多个主体办理备案，您可以生成备案授权码，分别在不同华为云账号为不同主体办理备案。如需要备案的主体数量较多，请增加购买服务器。 同一台服务器如备案多个主体，若其中任何一个备案主体出现问题，都有可能导致对应的IP被封禁、服务器关停而导致其他主体关联停用。因此，建议对服务器的网站分布做好合理规划分配。

（可选）授权备案授权码给他人 备案授权码可以跨账号使用，即弹性云服务器生成的5个备案授权码，不仅可以用于当前华为云账号，也可以供其他华为云账号备案。如需提供给其他华为云账号使用，请先授权。 打开“备案授权码”界面。 图4 备案授权码 选择供其他账号使用的备案授权码，单击“操作”列的“批量授权”选择需要授权的资源。 系统弹窗“授权其他账号”。 图5 授权给他人 输入授权给的华为云账号名，并单击“验证目标账号”。 验证输入的华为云账号名存在后，系统将显示您当前华为云账号绑定的手机号码。 图6 授权给他人-获取验证码 单击“获取验证码”，并将收到的短信验证码输入至“验证码”栏。 单击“确认授权”。

（可选）添加备案授权码自动审批账号 客户与客户之间可能为子公司等关系，若A用户拥有若干授权码，并想授权给B用户使用，添加B客户为白名单账号，当B客户备案时输入授权码，将自动审批，无需审核。 使用华为云账号登录备案系统 。 单击左侧导航栏的“授权码管理”，进入“备案授权码”界面。 单击“自动审批设置”。 输入“白名单账号”。 单击“添加”。 勾选“使用通知”方式。 白名单账号使用您的授权码时，会通过您勾选的方式通知您。 白名单账号授权码自动审批情况可在 “备案管理-我的授权-我授权的” 页面查看。 图7 备案授权码自动审批账号

备案授权码使用场景 对于跨账号的云资源类型，您可以通过备案授权码进行备案。 示例： 华为云账号A内无满足备案条件的服务器，您可以使用其他华为云账号（如账号B）内满足条件的弹性云服务器生成备案授权码进行备案。华为云账号B需满足如下要求： 用于生成备案授权码的弹性云服务器，需满足备案服务器的要求，即弹性云服务器是“包年/包月”计费模式，且绑定了弹性公网IP。 华为云账号B需授权备案授权码给账号A后，账号A才能使用该备案授权码。若账号A也可直接添加账号B为白名单账号，系统将自动审批授权。

主体负责人联系方式不准确 整改通知： 联系方式失效、联系方式未核实。 可能原因： 已备案主体负责人联系方式经拨打存在空号、停机、关机、无法接通等异常情况，可能是由于主体负责人联系方式变更。 整改建议： 1、请参考变更备案，填写新的主体负责人联系方式，并保持电话畅通。 2、请注意接听备案核验电话，或拨打950808转5主动申请核验。若联系方式已变更请提交变更备案修改联系方式 父主题： 主体信息不准确

网站信息超出许可范围 网站信息超出许可范围有几种可能性，如表1所示，请针对具体退回原因修改后，重新提交备案申请。 表1 表1 网站信息超出许可范围 退回原因 说明 个人申请超出个人范围的网站备案 详情请参见个人备案与单位备案的区别。 网站内容涉及前置审批而无许可 详情请参见前置审批。 网站名称与备案主体无明显关系 详情请参见网站名称要求。 域名数量超限 具体以各地管局要求为准。 以江西省为例：江西个人备案，一个主体下只可以有4个网站，一个网站只能提交一个域名，因此，域名超出4个会被退回。 父主题： 管局退回

填写开办者主体信息 1. 在弹出的提示窗口中或登录 新增主体 页，进行申请主体。如下图所示： 若系统未自动提示，请您单击业务办理页签，单击新增主体，即可申请主体。 如果您在本平台已办理过业务，可以通过关联旧账号将信息同步到新账号。 图6 新增主体 2.在开办主体管理页面，根据实际需求，填写开办主体的相关信息。 图7 填写开办主体信息 3. 根据页面提示逐步操作。 开办主体性质选择为个人，请按需填写负责人信息。 开办主体性质选择为单位，请按需填写主办单位信息和负责人信息。 4. 根据主体信息填写要求，进行填写后单击提交审核，弹窗出现新办网站申请、新增 APP等。 新增主体的审核时间为2~3个工作日。 请根据备案需求选择备案类型，以下请参考新办网站申请、新办APP申请。

注册与登录 1. 在 全国公安机关互联网站安全管理服务平台， 单击用户登录。 图1 用户登录 2. 进入登录页面后，单击注册账号。如果您已经有全国互联网安全管理服务平台的账号，可以直接登录。 个人备案请使用个人账号登录。 企业或单位备案请使用法人用户账号登录。 图2 注册账号 3. 根据页面提示填写信息，单击下一步。 图3 填写信息 4. 根据弹出二维码验证页面，请先扫描左侧二维码下载“公安一网通办” APP，再使用该 APP 扫描右侧二维码进行实人认证。完成互联网站安全服务平台的账号注册。 图4 实人认证 5. 返回登录页面，单击用户登录。 6. 输入您注册的账号、密码，以及验证码，单击登录。在实名认证步骤再次完成APP扫码认证。扫码认证完成后页面自动跳转至全国互联网安全管理服务平台页面（说明您已注册成功）。 7. 如果您之前在旧平台注册过账号，且账号的主体之前填写并审核通过了，在新平台登录进去之后，您可以单击关联旧账号。 图5 关联账号 8. 在关联旧账号对话框中完成相关配置项设置后，单击确认完成旧账号绑定操作，把之前的主体信息同步过来。

软件包完整性校验 用户可对下载的SDK包进行完整性校验，判断下载过程中是否存在篡改和丢包现象。 详细操作如下所示： 在表1中下载SDK包及其完整性校验sha256包至本地。 打开本地命令提示符框，输入如下命令，在本地生成已下载SDK包的SHA256值。 其中，“D:\HWLLS_SDK_Web_2.6.0.tar.gz”为SDK包本地存放路径和SDK包名，请根据实际情况修改。 certutil -hashfile D:\HWLLS_SDK_Web_2.6.0.tar.gz SHA256 命令执行结果示例，如下所示： SHA256 的 D:\HWLLS_SDK_Web_2.6.0.tar.gz 哈希: 3ac83be852e8dcc9e90f236801fd4c494983073543e1ae66ee4d0c29043dccd1 CertUtil: -hashfile 命令成功完成。 比对查询出的SDK包SHA256值和下载后的SDK包SHA256值。 如果一致，说明下载过程中不存在篡改和丢包现象。

合规使用指南 华为云Live云直播低时延直播场景SDK开发者合规指南 《中华人民共和国个人信息保护法》自2021年11月1日起正式施行后，监管部门、各行业参与方和终端消费者越来越关注用户的隐私保护问题。为了有效治理App、SDK违规收集使用个人信息的现象，监管部门也陆续出台相关标准规范。 您作为开发者为最终用户提供服务，知悉并确认将遵守适用的法律法规和相关的标准规范，履行个人信息保护义务，并遵循合法、正当、必要和诚信的原则处理用户个人信息，包括但不限于《中华人民共和国个人信息保护法》、《中华人民共和国网络安全法》、《中华人民共和国数据安全法》以及其他适用的法律法规和相关的标准规范。 此文档用于帮助您更好地了解【华为云低时延直播SDK】并合规的使用【华为云低时延直播SDK】服务，仅适用于开发者的业务区域为中国大陆地区的场景。 一、基本要求 您的产品及服务需要尊重用户隐私，遵守国家的数据保护法律和法规。禁止参与任何干扰、干涉、损害、未授权访问任何终端设备、服务器、网络的活动。 1. 隐私政策要求 您需根据法律要求以自身名义发布隐私政策，并就个人信息的处理行为获取用户同意或取得其他合法性基础。隐私政策的要求包括不限于如下： 有独立文本，不能作为用户协议的一部分。 App首次运行收集处理个人信息前需要以醒目方式提示用户阅读隐私政策。隐私政策需方便用户查看，例如用户在App主功能界面中通过4次以内的点击或滑动操作可访问。 描述语言需要清晰通俗，符合通用语言习惯，避免使用有歧义的语言。 隐私政策内容要包含产品及服务收集个人信息的目的、方式和范围，个人信息处理者的名称和联系方式等。 您的产品及服务如涉及向第三方共享个人信息或集成了第三方的SDK时，需要在隐私政策中向用户进行披露和说明，获取用户的授权或同意。 2. 处理个人信息要求 您的产品及服务在处理用户个人信息时，需要遵守的要求包括不限于如下： 处理个人信息需要基于使用目的所必需，满足最小化原则。 实际收集和处理的个人信息范围、使用目的需要与隐私政策的范围保持一致。 收集个人信息的频率需与隐私政策保持一致，禁止超频次收集个人信息。 有明确的个人信息到期删除机制，个人信息的存留期与隐私政策保持一致，到期按时删除个人信息或对个人信息进行匿名化处理。 如涉及处理不满十四周岁未成年人个人信息前，应取得未成年人的父母或其他监护人的同意。 如涉及处理个人信息用于个性化推荐功能或大数据分析业务的，应告知并取得最终用户的授权同意情况下方可开展相关业务功能。 如涉及处理敏感个人信息前，应取得最终用户的单独同意。 如涉及跨境传输个人信息，需要按照国家网信部门会同国务院有关部门制定的办法和相关标准进行安全评估，并符合其要求。同时您还取得最终用户的单独同意。 支持用户方便的行使数据主体权利，例如查阅、复制、更正、删除个人信息等权利。 二、声明SDK处理的个人信息 在您接入、使用【华为云低时延直播SDK】服务前，我们要求您在隐私政策中向用户告知我们SDK的名称、SDK提供方名称、收集个人信息类型、使用目的、隐私政策链接，并获取用户的同意或取得其他合法性基础。您可以参考如下方式提供条款内容： 1. 以文字方式向用户告知 第三方SDK名称：华为云低时延直播SDK 第三方公司名称： 华为云计算 技术有限公司 收集个人信息类型： 音视频流、IP地址、运营商信息、WiFi状态、浏览器信息、操作系统信息、设备型号。 使用目的：为您提供音 视频直播 服务，向您提供低时延直播体验指标功能，以及方便问题定位。 隐私政策链接：隐私声明 2. 以表格方式向用户告知 第三方SDK名称 第三方公司名称 收集个人信息类型 使用目的 隐私政策链接 华为云低时延直播SDK 华为云计算技术有限公司 音视频流、IP地址、运营商信息、WiFi状态、浏览器信息、操作系统信息、设备型号 为您提供音视频直播服务，向您提供低时延直播体验指标功能，以及方便问题定位。 隐私声明 三、权限使用要求 我们SDK在提供服务时会最小化的使用系统权限，您需要根据实际使用的功能申请对应的系统权限并向用户告知征得其同意。 权限 权限描述 使用目的 无 无 无 四、延迟初始化要求 为了避免您的应用在未获取用户的同意前SDK提前处理用户的个人信息。我们提供了SDK初始化的接口 createClient(type: string)，请保证您的应用获取用户同意后才能调用此接口初始化SDK。 五、最小化使用功能要求 我们的SDK针对扩展功能和可选的个人信息的处理提供了配置能力，您可以基于业务诉求选择开启或关闭相关功能，低时延直播SDK提供开关上报日志的方法。 1. setReportConfig(reportConfig:ReportConfig)接口中reportConfig包含enable参数，设置为false时，不会进行日志上报，设置为true时，才会进行日志上报。 2. setLogLevel(level: string)接口中level设置为none，则关闭日志打印，设置为error、warn、info或者debug，则会输出对应日志打印。

Example示例 本章节为测试示例，方便您快速调通整个流程并体验。 具体操作如下： 解压Sdk后的目录。 图1 Sdk目录 确保环境已经安装dotnet 5.0（若没有安装，运行CloudVR-Web-SDK.exe会出现闪退）。 配置config.yml信息。 表1 参数说明 参数 说明 取值样例 ListenIp 监听ip 0.0.0.0 ListenPort 监听端口 8080 LaunchBrowser 运行CloudVR-Web-SDK.exe后是否自动打开网页 true AuthCode web页面访问的验证码 1A2B3c IAM Endpoint IAM终端节点 - SchedulerEndpoint Scheduler终端节点 - DomainName 账户名。 - UserName IAM用户名。 - Password IAM用户登录密码。 - ProjectName 项目名称。 - ApplicationId 应用ID，请确保云服务器已经安装该应用。 后续可以根据业务需求自行分配调度。 - ApplicationUser 应用用户名，应用使用者的唯一标识。 TestUser1 ApplicationLaunchArgs 应用启动参数。 - GpuIpType 使用ip类型（公网ip：public，私网ip: private, 私网ip使用场景：专线， vpn） public Resolution 分辨率 1080p 具体信息获取方式如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面，查看IAM用户名、账户名、项目名称信息。 在左侧服务列表中选择“VR云渲游平台”，在“应用管理”中选择应用ID。如果没有应用，请先创建应用。 在IAM_API终端节点查找区域对应的终端节点信息，选择全局终端节点或资源所在区域的终端节点。 图2 IAM的终端节点 在地区和终端节点查找CVR服务对应终端节点信息，根据资源所在区域选择相应的终端节点。 图3 终端节点信息 运行CloudVR-Web-SDK.exe可执行文件。 打开浏览器访问：http://127.0.0.1:8080。 在浏览器页面输入验证码，单击“登录”。 父主题： Web SDK

SDK接口 接口 描述 是否必选 Init.getDevice_id() 【功能说明】 获取设备id，用于作为渲染调度接口的请求参数。 详细使用请参考wwwroot/login.html文件。 是 Init.getDevice_type() 【功能说明】 获取设备类型，用于作为渲染调度接口的请求参数。 详细使用请参考wwwroot/login.html文件。 是 Init.getDevice_brand() 【功能说明】 获取设备品牌，用于作为渲染调度接口的请求参数。 详细使用请参考wwwroot/login.html文件。 是 Init.getProtocol_type() 【功能说明】 获取协议类型，用于作为渲染调度接口的请求参数。 详细使用请参考wwwroot/login.html文件。 是 cloudDesktopApp.loadApp() 【功能说明】 启动并加载云应用。 【请求参数】 详细使用请参考wwwroot/index.html文件。 是 cloudDesktopApp.on() 【功能说明】 回调函数。 ready：连接就绪。 exit：退出回调。 streamPause：串流画面暂停回调。 streamResume：串流画面恢复回调。 appClosed：远程app应用关闭回调。 否 cloudDesktopApp.appEnterFullscreen() 【功能说明】 进入全屏。 否 cloudDesktopApp.appExitFullscreen() 【功能说明】 退出全屏。 否 cloudDesktopApp.restartApp() 【功能说明】 重启远程app。 否 cloudDesktopApp.pauseStream() 【功能说明】 暂停串流画面。 否 cloudDesktopApp.resumeStream() 【功能说明】 恢复串流画面。 否 父主题： 客户端开发

SDK使用 获取X-Subject-Token和 ProjectId需要用到华为云账号、密码、项目名称，请参考获取IAM用户Token。 通过wwwroot/js/init.js文件，获取device_id，device_type，device_brand，protocol_type参数信息。具体可参考wwwroot/login.html文件。 获取gpu_ip，port，link_token，task_id。需要用到X-Subject-Token，device_id，device_type，device_brand，protocol_type。X-Subject-Token需要添加在请求头中，请参考VR云渲游平台节点调度API。 确保安全组配置中已放通所有UDP端口、TCP/10100-10101、TCP/10200-10201、TCP/10300-10301端口。 父主题： 客户端开发

SDK下载 如需获取VR云渲游平台CVR Web SDK，请执行以下操作： 打开SDK开发者中心。 选择“VR云渲游Web SDK”进行“SDK下载”。 获取WebSDK.zip文件，并解压。 解压后的文件如表 WebSDK.zip包含的文件所示。 表1 WebSDK.zip包含的文件 文件名 说明 README.md 使用说明 CloudVR-Web-SDK.exe Example示例服务的启动程序 version.txt 版本号文件 appsettings.json Example 示例服务程序配置文件(无需修改) config.yml Example 示例服务程序配置文件，运行示例前需要配置该文件 wwwroot/ wwwroot为SDK文件夹 父主题： Web SDK

Visual Studio 2017安装方法 下载Visual Studio 下载地址：https://docs.microsoft.com/en-us/visualstudio/productinfo/vs-roadmap 在归档版本中找到Visual Studio 2017并下载系统匹配的版本。 图1 下载Visual Studio 2017 安装并配置Visual Studio 双击下载的可执行文件进行安装。 图2 双击可执行文件 等待安装完成。 图3 安装Visual Studio 父主题： 附录

集成SDK 在Demo.cpp文件的main函数中，调用Windows SDK接口完成初始化。 访问https://cloudvr.obs.cn-east-3.myhuaweicloud.com/example.zip下载模板example项目。 打开“example/src”路径对应的main.cpp文件，以模板为基准按照本地项目的实际情况进行修改。 模板使用说明： 模板提供了三种类型的CVRParameter构造函数分别对应的初始化逻辑，只需要修改下图中各变量的值就可以使用，客户端会根据linkType的变量选择执行的逻辑： 图1 初始化3D业务时需要注意和修改的参数 A类(linkType = TYPE_ACCOUNT)：将账号密码等变量传入SDK内部，由SDK处理平台调度逻辑，之后进行VR业务的初始化。 该方式适用于对于定制要求不高，希望能尽快体验CVR服务的场景。 B类(linkType = TYPE_IAMTOKEN)：客户端通过账号密码访问IAM云服务，将获取到用户token和对应的projectID传入SDK内部，而不是直接传入账号密码。 该方式适用于客户端对账号安全有一定要求的场景。 C类(linkType = TYPE_GPUINFO)：客户端通过账号密码访问IAM云服务，在获取到用户Token和对应的projectID后，访问CVR服务的调度接口，获取到对应区域的GPU服务器的IP和Token，传入SDK内部，完成VR业务的初始化。 该方式适用于对调度策略有定制要求的场景。 您可以根据需要自行提取相关逻辑到自己的客户端中。

SDK接口参考 接口 描述 是否必选 IntentCVR() 【功能说明】 初始化IntentCVR接口。 是 CVRParameter(std::string userName, std::string userDomain, std::string userPassWord, std::string projectName) 【功能说明】 用户通过该接口配置华为云用户名及密码，客户端根据该信息访问华为云IAM 获取Token 后再连接至VR云渲游平台进行鉴权，以下简称“A类 CVRParameter构造函数”。 【请求参数】 userDomain：华为云租户名 userName：华为云用户名 password：华为云用户密码 projectName：项目名称 说明： 如何获取上述参数对应值，请参考： https://support.huaweicloud.com/sis_faq/sis_04_0032.html 是 CVRParameter构造函数包括A类、B类、C类，请根据需要自选其中一类使用。 三类构造函数的适用场景请参考SDK使用。 CVRParameter(std::string iamToken) 【功能说明】 用户可自行访问IAM获取Token，通过该接口注入Token进行CVRParameter初始化，以下简称“B类 CVRParameter构造函数”。 【请求参数】 iamToken：用户Token。 CVRParameter(std::string gpuIp, std::string gpuToken) 【功能说明】 用户自行获取gpuIp与gpuToken，通过该接口配置gpuIp与gpuToken用于设备直连GPU服务器，以下简称“C类 CVRParameter构造函数”。 【请求参数】 gpuIP：GPU服务器公网IP。 gpuIP的获取方式，请参考“渲染节点调度”。 gpuToken：访问GPU服务器所需鉴权Token。 gpuToken的获取方式，请参考“渲染节点调度”。 void setServiceDomain(std::string serviceDomain) 【功能说明】 设置Service域名，用于指定连接的 GPU云服务器 所在区域。 【请求参数】 ServiceDomain：Service域名。 ServiceDomain的取值，请参见“地区和终端节点”中的“终端节点（Endpoint）”。 是 void setAppId(std::string appID) 【功能说明】 设置设备要访问的应用。 【请求参数】 appID：应用对应的应用ID。获取应用ID，请参考APP ID的获取方法。 是 void setPort(int port) 【功能说明】 GPU默认监听端口是10020，如果您更改了GPU监听端口（如使用多路会话模式），则需要使用该接口修改客户端访问端口号 【请求参数】 port：指定设备发送连接请求的目的端口信息。 否 std::string initiateLoad(CVRParameter customParameter) 【功能说明】 加载相关参数，启动云应用流化业务，并对输入参数进行检验。 【请求参数】 customParameter：已经初始化的鉴权参数。 是 void setLocation(std::string location) 【功能说明】 设置客户端连接的目标云服务器所在区域。 【请求参数】 location：用于设置调度接口的策略，可以指定一个或多个区域，CVR服务会从指定区域中分配空闲的服务器。支持配置公有云region_id，如cn-east-3。 如果未设置location，默认为空数组，此时CVR服务会根据设备的调度策略进行GPU服务器的分配。 location的取值，请参见“地区和终端节点”中的“区域”。 否 void setProjectID(std::string projectID) 【功能说明】 设置访问客户端调度接口使用的项目ID。 【请求参数】 projectID：项目ID，用于访问调度接口。获取projectID，请参见“获取项目ID”。 否 仅使用B类的CVRParameter构造函数时需要传入该值。 void setApplicationUserID(std::string userID) 【功能说明】 设置访问客户端调度接口使用的用户标识ID，如不存在用户标识ID，则不需要设置。 【请求参数】 userID：用户标识ID，用于访问调度接口。 否 void setAppLaunchArgs(std::string appLaunchArgs) 【功能说明】 设置应用启动参数，如应用启动无额外参数，则不需要设置。 【请求参数】 appLaunchArgs：应用启动参数。 否 public void setResolution(String resolution) 【功能说明】 设置应用启动的分辨率，默认为1080p。 【请求参数】 resolution：应用启动的分辨率。可以设置的参数为“480p”，“540p”，“720p”，“1080p”，“2k”，“4k” 否 public String getResolution() 【功能说明】 获取设置的应用启动分辨率。 【请求参数】 无 否 public void setGpuIpType(String gpuInfoType) 【功能说明】 设置gpu服务器ip的类型，默认为public。 【请求参数】 gpuInfoType：gpu服务器ip的类型，弹性公有ip填“public”,私有ip填"private"。 否 public String getGpuIpType() 【功能说明】 获取设置的gpu服务器ip类型。 【请求参数】 无 否 std::string getDeviceID() 【功能说明】 获取设备ID。 【请求参数】 无 否 仅使用C类的CVRParameter构造函数时需要获取该值。 std::string getBrand() 【功能说明】 获取设备品牌。 【请求参数】 无 否，仅使用C类的CVRParameter构造函数时需要获取该值。 void setErrCallback(CvrErrCallback errCallback) 【功能说明】 用于获取SDK内部的错误信息并处理。 【请求参数】 errCallback：回调接口，支持用户自定义。相关注意事项请参考错误信息回调。 否 CVRInstance_t* CVRCreateInstance() 【功能说明】 创建一个云应用客户端实例。 【请求参数】 无 是 CVRCode CVRSetConfig(CVRInstance_t* thiz, CVRConfig_t* config) 【功能说明】 对云应用客户端实例设置属性。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 config：CVRConfig_t类型的初始化参数对象。 是 CVRCode CVRStart(CVRInstance_t* thiz) 【功能说明】 开始显示画面。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 是 void CVRSetLogLevel(int level); 【功能说明】 设置日志级别。 【请求参数】 level：范围[0-8]。数值越大，日志越详细。 否 CVRCode CVRSetRenderView(CVRInstance_t* thiz,void* view) 【功能说明】 画面显示在指定窗口句柄。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 view：一个窗口句柄。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 CVRCode CVRSetControlStateChangedCallback(CVRInstance_t* thiz, CVRControlStateChangedCallback_t callback,void* user_data) 【功能说明】 设置主控模式状态变化的回调通知。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 callback：事件触发时的回调函数。 view：一个窗口句柄。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 CVRCode CVRSetOnVideoSizeChangedCallback(CVRInstance_t* thiz, CVROnVideoSizeChangedCallback_t callback,void* user_data) 【功能说明】 设置当前视频大小变化的回调通知。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 callback：事件触发时的回调函数。 user_data：设置回调函数中自定义数据。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 CVRCode CVRSetShowDebug(CVRInstance_t* thiz,int show_debug) 【功能说明】 是否显示调试参数。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 CVRCode CVRGetStatistics(CVRInstance_t* thiz, CVRStatistics_t* statistics) 【功能说明】 获取当前串流的统计数据。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 statistics：接收相关统计数据的外部变量。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 是 CVRCode CVRGetAuth(CVRInstance_t* thiz, CVRAuth* out_val) 【功能说明】 获取当前是主控客户端还是旁观客户端。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 out_val：接收当前模式的变量。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 CVRCode CVRSetOnAppClosedCallback(CVRInstance_t* thiz,CVROnAppClosedCallback_t callback,void* user_data) 【功能说明】 设置应用关闭的回调通知。 【请求参数】 thiz：由CVRCreateInstance()创建的云应用客户端实例。 callback：事件触发时的回调函数。 user_data：设置回调函数中自定义数据。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 CVRCode CVRRestartApp(CVRInstance_t* thiz,bool cancel) 【功能说明】 重新启动应用。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 CVRCode CVRPause(CVRInstance_t* thiz) 【功能说明】 暂停云应用资源。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 CVRCode CVRResume(CVRInstance_t* thiz) 【功能说明】 恢复云应用资源。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 否 void CVRRelease(CVRInstance_t* thiz) 【功能说明】 获取资源并停止云应用。 【返回值】 返回CVRCode类型的返回码，如果值为CVR_CODE_OK常量，则为成功。 是 父主题： Windows SDK