用户指南
文档版本 10
发布日期 2021-09-30
版权所有 © 华为技术有限公司 2021。 保留一切权利。
非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传 播。
商标声明
和其他华为商标均为华为技术有限公司的商标。
本文档提及的其他所有商标或注册商标，由各自的所有人拥有。
注意
您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或 特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或暗示的声 明或保证。
由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文 档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
华为技术有限公司
地址： 深圳市龙岗区坂田华为总部办公楼 邮编：518129
网址： https://www.huawei.com
客户服务邮箱：[email protected] 客户服务电话：4008302118
目 录
1 使用简介...1
2 准备视频数据... 2
3 视觉服务...3
3.1 开通服务...3
3.2 （可选）购买视觉能力包... 4
3.3 创建作业...5
3.4 算法模板配置...12
4 视觉分析作业...14
4.1 查看作业状态...14
4.2 获取作业结果...15
5 边缘运行池...18
A 修订记录... 21
1 使用简介
视频分析服务（Video Analysis Service，简称VAS）依靠AI技术对视频进行智能分析，
提供了视频预处理、视频审核、视频内容分析、视频搜索等功能。视频分析服务包含 了对视频中目标的检测、追寻、属性识别、行为识别、内容审核、摘要、标签等能 力，在多种场景下为用户提供快捷高效的视频分析能力。
您可以在视频分析服务的管理控制台上使用服务。首次进入管理控制台时，您看到的 总览页面如图1-1所示。
图1-1 视频分析服务管理控制台
您可根据业务需求，直接对现有的视觉服务进行开通使用，使用流程如下：
1. 准备视频数据
2. 开通服务 3. 创建作业
4. 获取作业结果
2 准备视频数据
您在使用视觉服务前，需要先准备视频数据，然后才能使用视觉服务对视频进行算法 分析，获取结果。视频格式的要求请参见约束限制。
3 视觉服务
3.1 开通服务
根据服务功能的发布阶段，开通方式分为以下两种：
● 邀测/商用：目前邀测/商用阶段的服务功能，需要用户提供账号信息给对应功能的 技术支持，技术支持处理完后用户才可以使用服务的算法功能，具体请参见邀测/
商用功能的开通步骤。
● 公测：公测阶段的服务功能，用户可在控制台完成开通的操作，具体请参见公测 功能的开通步骤。
当前各个功能的发布阶段请参见功能的发布阶段。
邀测/商用功能的开通步骤
1. 登录控制台上的“我的凭证”界面，如图3-1所示。
图3-1 我的凭证界面
2. 获取用户的账号信息，邀测和商用需要的信息不相同，具体如下：
– 邀测：需要用户名和项目ID。
– 商用：需要账号名和项目ID。
3. 将已获取的账号信息提供给对应功能的技术支持。
4. 技术支持处理完成后，用户登录视频分析服务管理控制台可以看到具体的服务功 能，且操作列为“创建作业”时表示开通成功，如图3-2所示。
图3-2 服务功能展示
公测功能的开通步骤
1. 登录华为云的视频分析服务控制台。
2. 选择“服务”，会看到功能列表。
如果您是首次进入视觉服务界面，需要您进行公测申请，公测审批当前是人工审 批，一般需要等待1～2天，如遇节假日顺延。
3. 根据业务需求，选择待开通的功能（例如：视频OCR），单击操作列的“申请公 测”。
功能的公测申请无需审批，可实时开通。
4. 服务功能的操作列显示“创建作业”时表示开通成功。
服务功能只需开通一次即可，后续使用无需再申请。
功能的发布阶段
表3-1 发布阶段
服务 功能 发布阶段
视频审核 视频内容审核 商用
3.2 （可选）购买视觉能力包
当前仅“水利智能体”、“园区智能体”支持购买视觉能力包，您可根据业务需要，
购买相应的视觉能力包。
购买套餐包
1. 登录华为云的视频分析服务控制台。
2. 在“服务”界面，单击目标服务类型（“水利智能体”、“园区智能体”），进 入“视觉能力包列表”页面。
图3-3 选择需要购买视觉能力包额服务类型
3. 根据业务需求选择视觉能力包，单击“购买”，进入购买对应视觉能力包界面。
图3-4 购买对应视觉能力包
4. 规格确认无误后，单击“立即购买”，进入“订单确认”界面，确认订单无误 后，选择“去支付”，在支付界面完成付款，付款成功后即完成视觉能力包的购 买。
说明
已购买的视觉能力包不支持退订，购买前请确认。
3.3 创建作业
基于用户选择的服务功能，这里创建的作业，即是使用该功能对目标视频进行分析处 理。
创建作业有三种入口：
● 在“总览”页面，单击快速入门下面的“创建作业”。
图3-5 创建作业（1）
● 在“服务”页面，单击目标功能操作列的“创建作业”。
图3-6 创建作业（2）
● 在“作业”页面，单击“新增”。
图3-7 新增作业
作业的算法配置结构和数据的输入输出类型，均在创建算法时已确定默认配置。
操作步骤
1. 登录视频分析服务管理控制台。
– 在“总览”页面，单击快速入门下面的“创建作业”。
– 在“服务”页面，单击目标功能操作列的“创建作业”。
– 在“作业”页面，单击“新增”。
2. 进入视觉作业的创建界面，各参数如表3-2所示。
图3-8 创建视觉分析作业
表3-2 视觉作业配置
作业参数 配置说明 配置样例
名称 您自定义作业名称。 Work02
描述 自定义作业描述信息，以便记忆和区分。 -
任务类型 分为“普通任务”和“计划任务”。 普通任务
服务类别 选择视觉服务的类别。 视频内容分析
服务功能 ● 若是通过“服务”页面创建作业，服务功能 和功能版本无需选择，版本会默认选择最新 的。
● 若是通过“作业”页面来创建作业，则需要 您选择服务的功能名称和功能版本。
选定服务功能时，会提示您进行服务授权，目 的是允许作业读取您指定的OBS桶和路径下的 视频数据，并且在作业运行成功后，将具体结 果文件保存在您指定的OBS桶和目录下。
服务授权时，如果提示“The number or agencies has reached the maximum.”，需 要您到统一身份认证服务，对委托进行删除或 创建新的委托。
暴力分拣识别
功能版本 选择功能版本。 1.0
边缘运行池 如果选择的服务功能需要使用边缘运行池，则 需要选择对应的边缘运行池信息。边缘运行池 的相关信息请参考边缘运行池。
如果边缘节点中已绑定设备，但是选择列表中 无法选择边缘设备，可参考IEF服务配置给设 备添加标签。
-
视觉能力包 选择购买的视觉能力包。
创建作业总的视频路数不能超过这个能力包对 应的视频路数。如果算法服务是需要用户购买 视觉能力包（eg，边缘交通智能算法能力 包），使用该服务下发作业时，就需要提供视 觉能力包名称以及对应的订单号。目前视觉能 力包的购买请联系技术支持进行购买。
-
算法模板配置 各个功能对应算法模板的参数不同，具体请参
见算法模板配置。 -
作业参数 配置说明 配置样例 输入数据 选择待处理的视频数据的路径，有以下可选来
源。相关配置可参考步骤 3。
● OBS：视频数据存储在OBS上时，这里只需 要选择桶和路径，在操作列选择部分视频文 件，或全选视频文件即可。
● VIS：通过视频接入服务接入实时数据时，
需要填写VIS的数据流名称。
● Edge Camera：从指定的边缘摄像头读取 视频数据。
● URL：从指定的URL地址中读取视频数据。
暂只支持OBS的URL，且需要设置该URL对 匿名用户可读取权限，设置方法请参见桶的 访问权限。
● Edge Restful：从客户自定义的流媒体服务 器读取数据。
● VCN：从VCN中读取视频数据。
说明
输入数据路径来源的可选项与算法配置相关，具 体请参考各算法服务对应的相关资料。
OBS
输出类型 选择视频处理后的结果文件的存放路径，有以 下可选路径。相关配置可参考步骤 4。
● OBS：选择将结果输出到OBS时，可选择已 有的桶和路径，也可以选择自定义的OBS地 址。
1. 选择已有：选择已有的桶和路径后，可 在该路径下获取作业结果文件。
2. 自定义输出：选择对应的存储地址，并 输入存储路径，从该路径获取作业结果 文件。
● DIS：支持将结果数据输出到DIS指定的通 道。
● DMS：暂不支持。
● Webhook：支持通过post请求，将作业的 运行结果直接发送给用户设置好的终端地址 Webhook URL。
● Local Path：支持将作业的运行结果保存在 边缘节点本地（节点需为Linux系统），必 须为linux路径，例如“/opt/cloud/”。这 个路径由用户在创建作业时设置的“挂载源 路径”参数决定。
● Hosting：选择Hosting时，结果数据存储 在OBS服务上，且存储的桶和路径均是服务 拥有者指定的。具体路径请参见获取作业结 果。
OBS
3. 功能版本、输入数据和输出类型，系统会根据选择的服务功能默认匹配。您也可 以手动更改视频数据来源，目前支持以下来源：
a. OBS：视频数据来自OBS时，创建作业的数据输入只需要选择OBS桶和路 径，在操作栏单击“选择”或“本页全选”，选择视频文件。
图3-9 OBS 类型输入数据
b. URL：支持视频数据来自OBS的URL链接，例如，https://obs-vcm.obs.cn- north-1.myhuaweicloud.com/videos/est_h264.mp4。
图3-10 URL 类型输入数据
c. Edge Camera：数据来自边缘摄像头时，需要选择边缘节点和边缘摄像头，
然后在操作栏单击“选择”或“本页全选”，选择摄像头。
图3-11 Edge Camera 类型输入数据
d. VCN：视频数据来自VCN时，创建作业的数据输入需要填写VCN的“IP地 址”、“端口”、“用户名”、“密码”和“摄像头ID”。
图3-12 VCN 类型输入数据
4. 配置结果文件的存放路径：
a. OBS：当输出数据类型为OBS时，支持两种输出方式：
▪
选择已有：选择已有的桶和路径，从该路径获取作业结果。▪
自定义输出：选择对应的存储地址，并输入存储路径，从该路径获取作 业结果。图3-13 OBS 输出类型
b. DIS：当输出数据类型为DIS时，输出结果需要指定具体的通道名。
图3-14 DIS 输出类型
c. Hosting：当输出数据类型为HOSTING时，输出结果需要到作业详情页的
“算法结果输出”栏查看具体路径，具体请参见获取作业结果。
d. Local Path：仅边缘作业支持，当输出数据类型为LOCALPATH时，输出结果 数据将会留在边缘节点本地（需Linux系统），用户需要填写存放结果的边缘 节点的本地路径，必须为linux路径，例如“/opt/cloud/”。
图3-15 Local Path 输出类型
e. Webhook：仅边缘作业支持，当输出数据类型为Webhook时，服务使用post 请求将作业的运行结果直接发送给用户设置好的Endpoint。用户需要对 Webhook的URL和请求头进行配置。
图3-16 Webhook 输出类型
5. 完成配置后，单击“立即创建”，完成创建作业。
系统返回“作业”界面，单击已创建作业的作业名可查看该作业的详细信息。
图3-17 作业列表
3.4 算法模板配置
在创建视觉服务的作业时，系统已经定义好了算法模板的结构和配置项，您只需要根 据实际需求输入具体的值，如图3-18所示。
图3-18 算法模板配置
视频 OCR
参数 参数说明 取值样例
文本置信度阈值 控制输出文字的置信度，值越高，文字的精准度 就越高，但对应的召回率会降低。取值范围为 [0，1.00]，默认值为0.50。
0.70
选择文本区域 文字区间选择，以“;”作为不同区域的分割符 号，每一个区域的前两个数值，代表区域左上角
（x，y）的百分比坐标；后两个数值代表所选区 域宽、高占图片百分比数值。取值范围为[0，
1]，无默认值。
0,0,0.5,0.5;
0,0.5,0.5,0.5;
4 视觉分析作业
4.1 查看作业状态
在创建完作业后，可在“作业”页面查看所有作业的状态、数据源和对应的视觉服务 名称以及作业的相关操作按钮。
图4-1 作业列表
您也可以使用视频分析服务提供的时间过滤功能和状态选择栏，以及名称搜索框对指 定作业进行过滤和查找。现在算法服务创建的作业主要有以下状态：
● 等待中：作业没有申请到资源，排队等待过程。
● 恢复中：作业正在进行恢复。
● 启动中：作业处于启动中。
● 更新中：作业处于自动升级状态。
● 创建失败：作业创建失败。
● 启动失败：作业启动失败。
● 运行中：作业正常运行过程中。
● 停止中：运行的作业正在停止。
● 已终止：作业已经终止运行。
● 异常：可能会自动恢复。
● 运行失败：作业运行失败。
● 删除中：作业正常删除过程中。
● 冻结中：用户欠费会冻结正在运行的作业，作业处于冻结过程中。
● 已冻结：作业已经在底层删除成功，在保留期内用户充钱后会重新启动。
您可以根据以上作业状态来判断作业是否正常运行。当创建的作业处理运行成功后，
按照创建视觉分析作业时选择的输出类型和路径查看作业结果。也可以单击作业名 称，查看作业的详细信息，包括作业结果的输出路径。
4.2 获取作业结果
您可以根据作业状态来判断作业是否正常运行。当创建的作业处理运行成功后，按照 创建视觉分析作业时选择的输出类型和路径查看作业结果。也可以单击作业名称，查 看作业的详细信息，包括作业结果的输出路径。
OBS/DIS/Webhook/Local Path 输出类型
当创建视觉作业中“输出类型”选择OBS/DIS/Webhook/Local Path时，您指定的结果 存放路径可以在作业详情页的“算法结果输出”栏获取，如图4-2所示。
图4-2 作业结果路径
Hosting 输出类型
当创建视觉作业中您选择了作业的输出类型为Hosting时，需要您在作业运行成功后，
单击作业名称进入到作业详情页面，获取具体的算法运行结果或路径。
有以下2种方法获取作业结果文件：
● 在“算法结果输出”栏获取算法运行结果文件，其中结构化文件为json文件，且 所有输入视频的结果文件都会合并到一个名为result.json的文件中，文件默认保存 48小时。
如果您只需要查看所有视频的总体结果，既可以到OBS上下载result.json文件，也 可以用方法2获取。
图4-3 结果输出路径
● 在“托管结构化结果”栏获取result.json，可以单击“下载JSON文件”进行下 载。需要您注意的是，文件默认保存48小时，您必须在过期时间前下载，过期后 文件将无效。
图4-4 获取 JSON 结果文件
5 边缘运行池
边缘运行池是用户边缘侧的运行节点集合。用户需为边缘运行池设置运行的视频服务 及期望运行的最大视频流路数。用户创建对应视频服务的作业后，VAS会调度选择合适 节点运行视频算法容器，进行视频作业的处理。
创建边缘运行池
1. 登录视频分析服务管理控制台。
2. 选择“边缘运行池”，单击“新增”。
图5-1 新增边缘运行池
3. 在创建边缘运行池页面配置相关参数。
图5-2 创建边缘运行池
表5-1 创建边缘运行池参数说明
参数 说明
名称 边缘运行池名称。
只能由中文, 英文字母(a~z, A~Z)、数字(0~9)、中划线(-)、下划 线(_)组成, 长度范围为[1, 100]。
描述 自定义边缘运行池描述信息，以便记忆和区分。
服务功能 选择边缘运行池的服务功能。
功能版本 服务功能选择后，功能版本会自动匹配，无需配置。
资源类型 目前只支持边缘节点类型。
边缘节点 选择接入的边缘节点，可以选择多个。如果还未接入边缘节点，
请参考注册边缘节点进行添加。如果创建作业里，边缘设备的选 择不了，选择列表为空，但实际边缘节点中已绑定设备，可以在 边缘节点关联的摄像头设备设置iva_device_type=camera标签，
详细可以参考IEF服务配置。
服务实例ID 此参数为IEF服务注册的铂金版实例ID。
为了避免错误，建议直接拷贝服务实例ID。
最大视频
流路数 允许通过的最大视频流路数。
此参数为所有边缘节点接入的视频流路数的总和。
容器挂载
路径 设置主机的一个目录，容器启动时，可以挂载这个目录到容器 内。
最多可输入64个字符。
4. 配置完成后，单击“立即创建”。
可在边缘运行池页面查看创建的边缘运行池信息。
A 修订记录
发布日期 修订记录
2021-09-30 第十次正式发布。
下线“市场订阅”。
2021-08-28 第九次正式发布。
下线视频指纹、视频编辑、视频人物分析相关内容。
2021-01-30 第八次正式发布。
新增（可选）购买视觉能力包 2020-09-17 第七次正式发布。
新增“市场订阅”。
2020-09-09 第六次正式发布。
删除人脸提取、人流量统计、车辆识别、入侵检测相关内容。
2020-04-26 第五次正式发布。
修改边缘运行池。
2019-12-25 第四次正式发布。
新增边缘运行池。
2019-11-28 第三次正式发布。
新增视频审核，算法模板配置新增对应的算法配置。
2019-05-31 第二次正式发布。
● 更新开通服务章节。
● 人脸提取、人流量统计、车辆识别、入侵检测上线公测，
算法模板配置新增对应的算法配置。
2018-12-30 第一次正式发布。
