华为云用户手册

CBR自定义策略样例 示例1：授权用户创建、修改和删除存储库 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "cbr:*:get*", "cbr:*:list*", "cbr:vaults:update", "cbr:vaults:delete", "cbr:vaults:create" ] } ]} 示例2：拒绝用户删除存储库和备份 拒绝策略需要同时配合其他策略使用，否则没有实际作用。用户被授予的策略中，一个授权项的作用如果同时存在Allow和Deny，则遵循Deny优先原则。 如果您给用户授予CBR FullAccess的系统策略，但不希望用户拥有CBR FullAccess中定义的删除存储库权限，您可以创建一条拒绝删除存储库和备份的自定义策略，然后同时将CBR FullAccess和拒绝策略授予用户，根据Deny优先原则，则用户可以对CBR执行除了删除存储库和备份外的所有操作。拒绝策略示例如下： { "Version": "1.1", "Statement": [ { "Effect": "Deny", "Action": [ "cbr:backups:delete", "cbr:vaults:delete" ] } ]} 示例3：多个授权项策略 一个自定义策略中可以包含多个授权项，且除了可以包含本服务的授权项外，还可以包含其他服务的授权项，可以包含的其他服务必须跟本服务同属性，即都是项目级服务或都是全局级服务。多个授权语句策略描述如下： { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "cbr:vaults:create", "cbr:vaults:update", "cbr:vaults:delete" ] }, { "Effect": "Allow", "Action": [ "sfs:shares:createShare" ] } ]}

Linux系统替换CA证书操作步骤 登录已安装客户端的Linux服务器。 执行以下命令，防止系统超时退出。 TMOUT=0 执行以下命令，切换至“rdadmin”用户。 su - rdadmin 执行以下命令，进入客户端启动/停止脚本所在路径。 cd /home/rdadmin/Agent/bin 执行以下命令，停止客户端运行。 sh agent_stop.sh 执行以下命令，进入CA证书所在路径。 cd /home/rdadmin/Agent/bin/nginx/conf 执行以下命令，将原来的CA证书文件删除。 rm bcmagentca.crt 将新的CA证书文件复制至/home/rdadmin/Agent/bin/nginx/conf目录中，并重命名为bcmagentca.crt。 执行以下命令，修改CA证书属主。 chown rdadmin:rdadmin bcmagentca.crt 执行以下命令，修改CA证书权限。 chmod 400 bcmagentca.crt 执行以下命令，进入客户端启动/停止脚本。 cd /home/rdadmin/Agent/bin 执行以下命令，启动客户端。 sh agent_start.sh

修改rdadmin账号密码操作步骤 进入弹性云服务器界面，登录已创建好的Windows操作系统弹性云服务器。 进入“控制面板”，单击“用户账户”。 单击“管理用户账户”。弹出“用户账户”对话框。选择用户名“rdadmin”，并单击“重置密码”。 输入新密码，确认无误后单击“确定”。 进入“任务管理器”，在“服务”页签，单击“打开服务”。 分别选择RdMonitor和RdNginx服务，在弹出的属性对话框中选择“登录”，将密码修改为步骤4中输入的新密码并单击“确定”，完成修改密码。

Windows系统替换CA证书操作步骤 登录到已安装客户端的弹性云服务器。 进入“安装路径\bin”目录中。 执行agent_stop.bat脚本，停止客户端运行。 进入“安装路径\nginx\conf”目录。 删除bcmagentca.crt证书文件。 将新的CA证书文件复制到“安装路径\nginx\conf”目录中，并重命名为bcmagentca.crt。 再次进入“安装路径\bin”目录。 执行agent_start.bat脚本，启动客户端。

Linux系统替换服务器证书操作步骤 登录已安装客户端的Linux服务器。 执行TMOUT=0命令，防止“PuTTY”超时退出。 执行该命令后，当前系统在无操作时会保持运行状态，存在安全风险，为了确保系统安全，请在完成相应操作后，执行exit退出当前系统。 执行su - rdadmin命令，切换为“rdadmin”用户。 执行cd /home/rdadmin/Agent/bin命令，进入脚本所在路径。 Agent的安装路径固定为“/home/rdadmin/Agent”。 执行sh agent_stop.sh命令，停止客户端运行。 将新的证书和私钥文件放到指定目录。 新的证书必须放到“/home/rdadmin/Agent/bin/nginx/conf”目录下。 执行/home/rdadmin/Agent/bin/agentcli chgkey命令。 显示如下回显信息： Enter password of admin: “admin”为安装Agent时设置的用户名。 输入Agent登录密码，按“Enter”。 显示如下回显信息： Change certificate file name: 输入新的证书名称，按“Enter”。 如果私钥文件和证书是同一个文件，证书和私钥文件名称都为该文件名称。 显示如下回显信息： Change certificate key file name: 输入新的私钥文件名称，按“Enter”。 显示如下回显信息： Enter new password: Enter the new password again: 输入两次私钥文件的保护密码，替换证书成功。 执行sh agent_start.sh命令，启动客户端。

Windows系统替换服务器证书操作步骤 登录已安装客户端的Windows服务器。 打开命令行窗口，进入“安装路径\bin”目录。 执行agent_stop.bat命令，停止客户端运行。 将新的证书和私钥文件放到指定目录。 新的证书必须放到“安装路径\bin\nginx\conf”目录下。 执行agentcli.exe chgkey命令。 显示如下回显信息： Enter password of admin: admin”为安装客户端时设置的用户名。 输入新的证书名称，按“Enter”。 如果私钥文件和证书是同一个文件，证书和私钥文件名称都为该文件名称。 显示如下回显信息： Change certificate key file name: 输入新的私钥文件名称，按“Enter”。 显示如下回显信息： Enter new password: Enter the new password again: 输入两次私钥文件的保护密码，替换证书成功。 执行agent_start.bat命令，启动客户端。

安装失败，提示“Incorrect IAM authentication information” 问题现象： 安装客户端时失败，提示“Incorrect IAM authentication information”。 图2 安装失败，提示“Incorrect IAM authentication information” 可能原因： 安装时，填写参数AK、SK可能不正确。 解决方案： 正确获取安装参数AK、SK，重新填写。 重新安装客户端。

示例流程 图1 给用户授予CBR权限流程 创建用户组并授权 在IAM控制台创建用户组，并授予云备份只读权限“CBR ReadOnlyAccess”。 创建用户并加入用户组 在IAM控制台创建用户，并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台，切换至授权区域，验证权限： 在“服务列表”中选择云备份，进入CBR的云服务器备份，单击右上角“ 购买云服务器 备份存储库”，尝试购买云服务器备份存储库，如果无法购买云服务器备份存储库，表示“CBR ReadOnlyAccess”已生效。 在“服务列表”中选择除云备份外的任一服务，如果提示权限不足，表示“CBR ReadOnlyAccess”已生效。

客户端状态显示异常 问题现象： 安装客户端后，界面上客户端列表里客户端状态为“异常”。 可能原因： 客户端状态异常 解决方案： 查看客户端进程是否正常运行；如果进程已退出，重新运行客户端进程。 Windows系统下可以双击agent_start.bat文件，Linux系统下执行命令service cbragent start。 重新安装文件备份客户端。 检查客户端时间和时区，如果发现客户端与服务器的时间相差大于15分钟，请根据本地UTC时间调整本地时间以避免此问题。如果调整完成后，客户端状态仍然异常，则是由于系统查询客户端状态不是实时的，需要等待半小时左右可恢复正常。

安装失败，提示“Could not resolve host” 问题现象： 安装客户端时失败，提示“Could not resolve host”。 图1 安装失败，提示“Could not resolve host” 可能原因： 本地的DNS服务器不能解析华为云的公网 域名 。 解决方案： 编辑本地主机的resolv.conf文件，查看是否配置域名服务器；如果是公网访问华为云，可以将域名服务器配置为“8.8.8.8”。 重新安装客户端。

Linux系统修改SNMPv3告警上报账号密码 使用服务器密码登录Linux系统服务器。 执行TMOUT=0命令，防止“PuTTY”超时退出。 执行该命令后，当前系统在无操作时会保持运行状态，存在安全风险，为了确保系统安全，请在完成相应操作后，执行exit退出当前系统。 执行su - rdadmin命令，切换为“rdadmin”用户。 执行/home/rdadmin/Agent/bin/agentcli chgsnmp命令，输入客户端登录账号的密码，按“Enter”。 客户端安装路径固定为“/home/rdadmin/Agent”。 Please choose operation: 1: Change authentication password 2: Change private password 3: Change authentication protocol 4: Change private protocol 5: Change security name 6: Change security Level 7: Change security model 8: Change context engine ID 9: Change context name Other: Quit Please choose: 选择需要修改的授权认证密码或 数据加密 密码对应序号，按“Enter”。 输入旧密码，按“Enter”。 输入新密码，按“Enter”。 再次输入新密码，按“Enter”。完成修改密码。

Windows系统修改SNMPv3告警上报账号密码 登录已安装客户端的云服务器。 打开命令行窗口，进入“安装路径\bin”目录。 输入agentcli.exe chgsnmp命令，输入客户端登录账号的密码，按“Enter”。 Please choose operation: 1: Change authentication password 2: Change private password 3: Change authentication protocol 4: Change private protocol 5: Change security name 6: Change security Level 7: Change security model 8: Change context engine ID 9: Change context name Other: Quit Please choose: “admin”为安装客户端时设置的用户名。 选择需要修改的授权认证密码或数据加密密码对应序号，按“Enter”。 输入旧密码，按“Enter”。 输入新密码，按“Enter”。 再次输入新密码，“Enter”。完成修改密码。

接口调用示例 请求导航路径 const utmCode = "51N"; const from: number[] = [0, 0, 0]; const to: number[] = [100, 0, 0];const policy: number = 0; XRClient.requestNavi(utmCode, from, to, policy, this.RequestNaviCallBack);//返回从出发地到目的地的路径 获取SDK版本号 XRClient.getVersion();

接口列表 表1 其他接口列表 接口 描述 参数名 参数类型 参数说明 返回值 requestNavi 请求导航路径。 utmCode string 当前utm区域。 void from number[3] 导航出发点utm坐标。 to number[3] 导航目的地utm坐标。 policy number 路线选择策略。 1：最短距离 2：电梯优先 3：扶梯优先 -2：不坐电梯 -3：不走扶梯 callback Function 回调函数，附带导航路径点信息。 getVersion 获取SDK版本号。 - - - string

总体开发思路 使用WebARSDK开发移动端应用的工作流程如图1所示。 图1 工作流程 准备工作。 下载WebARSDK、收集AK/SK信息、开通关联服务。 创建H5移动端工程。 使用原生或者流行框架（如Vue、React）创建H5移动端工程。 引入WebARSDK文件。 下载、解压WebARSDK包，并将下载WebARSDK包放入工程目录，通过外部引入脚本的方式引入WebARSDK文件。 验证租户身份信息。 通过hwar.setAKSK方法将AK/SK传入SDK，验证租户身份信息。 开启AR会话。 获取图像及传感器数据，初始化SLAM，准备相关环境。 实现AR导航和渲染3D内容。 依靠视觉定位，获取当前设备位置，以及请求导航路径，实现空间位置追踪导航；开发者基于SDK输出的图像数据、相机矩阵、路径信息，实现3D数字内容渲染。 父主题： WebARSDK使用手册

无法进行视觉定位原因排查 如果您无法进行视觉定位，建议您排查以下问题： 检查是否竖屏正向手持设备。 侦听事件“LANDSCAPE_BY_ROLL”检查当前屏幕是否竖屏。 侦听事件“ORIENTATION_NORMAL”检查屏幕正向状态。 验证视觉定位效果时，您需竖屏正向手持设备扫描周边环境。 检查定位区域是否在地图服务范围内。 按“F12”打开DevTools，在“Network”页签中查看“vps”的状态码。如果状态码为“400”，请在“Response”页签中查看“error_msg”内容，如显示“access denied, out of your service zone”，则表示位置不在您的地图服务范围。

接口调用示例 侦听事件 用于侦听事件，并触发侦听函数。 XRClient.addEvent(GlobalBus.VPS_RESULT, this.onVpsResult,this); 定义侦听函数。 onVpsResult(evt) { XRClient.log("onVpsResult status" + evt.data.status); XRClient.log("onVpsResult info" + evt.data.info); if (evt.data.status) { XRClient.log("VPS success"); wx.showToast({ title: 'success', icon: 'success', duration: 2000 }) } else { XRClient.log("VPS failure"); wx.showToast({ title: 'failure', icon: 'none', duration: 2000 }) } }, 移除侦听事件 用于移除事件，移除后侦听函数不再触发。 XRClient.removeEvent(GlobalBus.VPS_RESULT, this.onVpsResult); 派发事件 用于派发事件，配合侦听事件使用，接收到此处派发的事件，并做相应处理。 XRClient.dispatchEvent('user_define', { status: false, info: 'test' } );

SDK内部事件 表2 SDK内部事件列表 事件名称 描述 携带数据 数据类型 数据说明 事件说明 VPS_RESULT Vps定位结果事件。 status boolean 定位是否成功。 Vps定位结果返回时触发该事件。 info string 具体定位结果信息。 VPS_TRACKING Vps跟踪状态事件。 status boolean 状态是否为跟踪中。 Vps跟踪状态变化时触发。 SCENE_INSTANCE scene实例事件。 info object scene实例。 初始化视觉定位模块时，派发scene实例事件。

坐标系转换 SDK提供了UTM坐标与渲染引擎（如Three.js、LayaAir）坐标之间的转换方法。 // UTM坐标转成渲染坐标let vecInit = hwar.utm2Render([utm.x, utm.y, utm.z]);// 渲染坐标转成UTM坐标let renderPosUtm = hwar.render2Utm([render.x, render.y, render.z]);

接口调用示例 初始化日志模块 const logger=new Logger() //创建Logger实例XRClient.initLogger(logger)//初始化日志模块 日志存储 XRClient.setIsSaveLog(true) 设置日志存储为“true”，打印日志的同时会写入日志文件到手机（仅Android支持，iOS暂不支持）。 设置日志存储为“false”，不写入日志文件到手机。 设置日志打印级别 XRClient.setLogOutputLevel(1) 日志级别包括：0（不输出）、1 （error） 、 2 （warn）、 3（log） 设置日志级别为0：不输出日志。 设置日志级别为1：只输出error级别日志。 设置日志级别为2：输出error和warn二个级别日志。 设置日志级别为3：输出error、warn、log三个级别日志。 打印普通级别的日志 XRClient.log("打印内容") 打印警告级别的日志 XRClient.warn("打印内容") 打印错误级别的日志 XRClient.error("打印内容")

开发概述 HTSDK是接入KooMap AR地图运行服务的端侧SDK，助力于快速构建真实和虚拟融合世界。HTFoundation是适配HTSDK的示例代码，供用户在Unity3D中开发业务。 HTFoundation示例实现了真实世界构建、世界位姿定位和跟踪、虚实世界呈现。基于HTFoundation示例，用户可构建虚拟世界，包括虚拟对象设计、行为设计实现和业务逻辑开发。 图1 工作原理 父主题： HTSDK使用手册

接口列表 表1 事件接口列表 接口 描述 参数名 参数类型 参数说明 返回值 addEvent 侦听事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void cb Function 侦听到事件后，触发的回调函数。 cbThis any 当前实例。 removeEvent 移除侦听事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void cb Function 回调函数。 dispatchEvent 派发事件。 evtName string 事件ID。 根据实际情况选择Vps定位结果事件ID、Vps状态事件ID或scene实例事件ID。 void params { key: value, key2: value2 } 事件携带的信息，键值对形式。

接口列表 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 init 初始化视觉定位模块。 config { access: string, secret: string, beforeLocateDelta: number, afterLocateDelta: number, autoRequest: boolean, workerPath: string, url: string } 初始化配置参数。 access：认证用的AK。 secret：认证用的SK。 beforeLocateDelta：首次定位成功前每隔几秒触发一次自动请求。 afterLocateDelta：定位成功后每隔几秒触发一次自动请求。 autoRequest：是否开启Vps自动请求。 workerPath：Vps模块用到的worker文件路径。 url：触发定位请求时使用的域名。 void requestVps 触发定位请求。 - - - void updatePerFrame 更新相机位姿。 - - - void getCameraOffset 获取相机偏移量。 - - - number[3] getUTMPosition 获取UTM（UNIVERSAL TRANSVERSE MERCARTOR GRID SYSTEM，通用横墨卡托格网系统）坐标。 - - - number[3] destroyVps 销毁视觉定位实例。 - - - void mockVps 模拟定位。 position Vector3 位置，使用UTM坐标系。 void rotation Vector3 朝向，以弧度制表示的欧拉角。

环境要求 已安装配置NodeJS环境。 已安装代码编辑器，如Visual Studio Code。 已安装Web服务器，如http-server、VSCode插件live-server、Tomcat等。 Windows系统电脑已安装Chrome浏览器或基于Chromium内核的浏览器（例如Edge）；Mac系统电脑已安装Safari浏览器。 移动设备已配置后置摄像头、陀螺仪、加速度传感器、GPS芯片等器件。 移动设备已安装支持WebRTC浏览器，如Chrome、Safari、华为浏览器等。

定位失败，定位结果显示“FewPnPInliers”或“ErrorMeanReprojectionErrTooLarge” 原因一：可能是发起定位时使用的图片纹理特征不够明显。 解决方案：在移动端，对着纹理丰富的区域单击“手动请求Vps”重新发起定位。 原因二：可能是平面识别未初始化完成。 解决方案： 查看camera的position和rotation数值。 如果position数值为0，且rotation值不更新，说明平面识别未初始化完成。 对着平面左右平移提升初始化速度，等待初始化完成。 单击“手动请求Vps”重新发起定位。 原因三：移动端不支持V2平面接口。 解决方案： 查看日志确认当前移动端的arVersion版本，如果不是V2版本，则需更换移动端。 父主题： 常见问题

调用前须知 调用API前，您需提前了解如下内容： WebARSDK封装类名为“hwar”，所有API均直接通过类“hwar”来调用，无需实例化。 下文API中的GPS坐标系为WGS84坐标系。 utmCode指UTM（Universal Transverse Mercator Grid System，通用横墨卡托格网系统）投影带号。 图像流约束为宽:高=480:640，您需根据实际情况自行适配设备屏幕尺寸。 参数类型使用了TypeScript语言的声明规范。 父主题： API列表

续费相关的功能 包年/包月专属加密续费相关的功能如表1所示。 表1 续费相关的功能 功能 说明 手动续费 包年/包月专属加密实例从购买到被自动删除之前，您可以随时在DEW控制台续费，以延长使用时间。 自动续费 开通自动续费后，专属加密实例会在每次到期前自动续费，避免因忘记手动续费而导致资源被自动删除。 在包年/包月专属加密实例生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如图 专属加密实例生命周期所示。 图1 专属加密实例生命周期 专属加密实例从购买至到期前，处于正常运行阶段，功能均可用。 到期未续费时，首先会进入宽限期，宽限期到期后仍未续费，资源状态变为“已冻结”。 超过宽限期仍未续费将进入保留期，如果保留期内仍未续费，资源将被自动删除。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 在专属加密实例到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至到期或者续费成功。到期前7日自动续费扣款是系统默认配置，您也可以根据需要修改此扣款日。

计费模式概述 数据加密服务中的专属加密实例支持包年/包月（预付费）计费方式，密钥管理服务、凭据管理服务支持按需计费（后付费）计费方式。 包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费，按照云服务实际使用时长计费，秒级计费，按小时结算。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。一般适用于电商抢购等设备需求量瞬间大幅波动的场景。 表1 计费模式 计费模式 包年/包月 按需计费 付费方式 预付费。 按照订单的购买周期结算。 后付费。 按照云服务器实际使用时长计费。 计费周期 按订单的购买周期计费。 秒级计费，按小时结算。 适用计费项 专属加密实例 密钥管理服务、凭据管理服务 变更计费模式 不支持变更为按需计费模式。 不支持变更为包年/包月计费模式。 适用场景 适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。对于长期使用者，推荐该方式。 适用于计算资源需求波动的场景，可以随时开通，随时删除。 父主题： 计费模式

到期后影响 图2描述了包年/包月DEW资源各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图2 包年/包月DEW资源生命周期 到期预警 包年/包月DEW资源在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 到期后影响 当您的包年/包月DEW资源到期未续费，首先会进入宽限期，资源状态变为“已过期”。宽限期内您可以正常访专属加密实例 如果您在宽限期内仍未续费包年/包月DEW资源，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年/包月资源执行任何操作。 保留期到期后，如果包年/包月DEW资源仍未续费，那专属加密实例资源将被释放，数据无法恢复。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。