腾讯云智能视图计算平台对接使用完全指南：从零搭建视频上云与AI分析体系
一、平台概述：重新定义视频上云的方式
智能视图计算平台是腾讯云面向视频与图片数据推出的一站式解决方案，它将边缘接入治理、云端存储与AI多模态分析能力融为一体。这个平台的出现，有效回应了传统视频监控系统长期面临的五大痛点：存储成本前置无法灵活调整、分散设备难以集中管理、本地存储可靠性差、多品牌私有协议导致运维投入居高不下、端侧AI算力与算法单一。
依托腾讯云遍布全球的边缘视图节点，该平台支持终端设备从云下到云上全链路的接入管理、数据治理、数据存储与AI智能分析。无论是连锁门店的分散摄像头、园区工地的监控系统，还是智慧家居的安防设备，都可以通过标准协议快速接入云端，实现统一管理与智能分析。
平台提供了两种主要的使用方式：控制台与API。控制台适合运维人员通过可视化界面完成设备接入、实况预览、录像计划与AI分析等业务配置；API则面向开发者，提供完整的API 3.0接口，方便将平台能力集成到自有业务系统中。这种"控制台+API"的双轨设计，兼顾了易用性与灵活性。
需要先登录腾讯云控制台，点击：腾讯云控制台，还没有账号，点击：注册后再关联，已有账号点击：登录后再关联
二、开通服务：三步完成平台启用
在使用智能视图计算平台之前，需要完成账号注册、实名认证与服务开通三个步骤。
2.1 注册腾讯云账号
首先需要注册一个腾讯云账号。如果您已有账号，可以直接跳过此步骤。注册完成后，使用该账号登录腾讯云控制台。
2.2 完成实名认证
登录控制台后，需要进行实名认证。值得注意的是，智能视图计算平台需要完成企业认证后才可使用。详细的操作指引可以参考腾讯云的实名认证文档。
2.3 提交使用申请并开通服务
在控制台中选择"云产品 > 智能视图计算平台"，进入产品页面后提交使用申请。平台为了更好地了解您的需求，会先进行审核。审核通过后，再次登录进入产品控制台，授予产品相关权限后即表示开通服务。新用户首次登录时，需要创建服务预设角色并授予产品相关权限，完成该操作后即可使用产品。
三、设备接入：让摄像头快速上云
设备接入是使用智能视图计算平台的第一步。平台支持多种接入协议，包括GB/T28181、RTMP、HTTP等标准协议。如果通过网关接入，还支持ONVIF协议以及海康、大华、宇视等主流厂商的私有SDK。
3.1 前提条件：配置播流域名
在添加设备之前，需要先配置播流域名，否则无法添加设备。域名配置是设备接入的基础，后续生成的播流地址将基于此域名。
3.2 创建设备组织
设备组织是用于挂载设备的逻辑树结构，后续使用各功能的过程中都将围绕设备组织展开。组织数量没有限制，但纵向层级限制为9层，建议按照"省—市—区/县—乡/镇/街道—村/户—具体场所"等行政区域进行划分。组织名称在全局范围内必须唯一且不可重复。每个组织会显示其下挂载的在线设备数量和总设备数量。
在控制台左侧导航栏中单击"设备接入"，进入设备接入管理页面后，单击"+"号即可创建设备组织并自定义组织名称。将鼠标移动到具体组织上，还可以进行组织名称的快捷编辑、删除及添加下级组织。
3.3 GB/T28181协议设备接入
GB/T28181是国内视频监控领域最主流的国家标准协议，绝大多数IPC和NVR设备都支持该协议。接入步骤如下：
第一步，选择具体的设备组织，单击"添加设备"，选择GB28181协议。第二步，填写设备的基本信息，包括设备名称、设备ID等。第三步，设备添加完成后，单击设备名称进入设备详情页面，查看国标配置信息。这些信息包括SIP服务器ID、SIP服务器域名、SIP服务器端口、设备ID等。第四步，将平台提供的国标配置信息填入IPC或NVR设备的国标配置界面。第五步，设备端填写完成后，设备会自动向平台注册。此时可以通过调用DescribeUserDevice接口查询设备详情，通过Status字段判断设备状态——0表示未注册，1表示在线，2表示离线，3表示禁用。
对于GB28181协议设备，平台还提供了一些扩展功能：音频开关用于控制是否接受设备音频；目录订阅支持主动订阅NVR设备下视频通道的实时状态；流传输协议支持选择TCP或UDP。平台会为每个视频通道生成HTTP-FLV、RTMP、HLS三种协议的实时播流地址，供应用集成使用。
3.4 RTMP协议设备接入
RTMP协议是另一种常用的设备接入方式，特别适合推流场景。RTMP设备与通道是强绑定关系，即设备在线则通道一定在线。RTMP设备创建后，默认通道数量为1。接入步骤与GB28181协议类似，在添加设备时选择RTMP协议即可。
3.5 设备批量操作与通道管理
平台支持设备的批量操作，可以选中多台设备进行设备移动、启用、禁用、删除以及同步设备下视频通道等操作。单击具体的通道数，可以查看该设备下所有视频通道的详细信息，包括通道名称、状态、编码及流状态。单击"同步通道"可以刷新获取最新的视频通道信息。
四、API对接：将平台能力融入自有系统
智能视图计算平台提供了完整的API 3.0接口，开发者可以通过API调用实现设备管理、录像控制、AI分析等全部平台能力。
4.1 API请求结构
API支持就近地域接入，推荐使用就近地域接入域名iss.tencentcloudapi.com。根据调用接口时客户端所在位置，会自动解析到最近的服务器。对于对时延敏感的业务，建议指定带地域的域名，例如广州地域的域名为iss.ap-guangzhou.tencentcloudapi.com。
所有API接口均通过HTTPS进行通信，提供高安全性的通信通道。支持的HTTP请求方法包括POST（推荐）和GET，POST请求支持的Content-Type类型包括application/json（推荐，必须使用签名方法v3）、application/x-www-form-urlencoded（必须使用签名方法v1）以及multipart/form-data（仅部分接口支持）。字符编码统一使用UTF-8。
4.2 Python SDK调用示例
以下是一个完整的Python SDK调用示例，演示如何创建设备、查询设备状态、创建录像计划和配置AI任务。
# 安装腾讯云Python SDK
# pip install tencentcloud-sdk-python
import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.iss.v20230517 import iss_client, models
# 配置认证信息
secret_id = "您的SecretId"
secret_key = "您的SecretKey"
cred = credential.Credential(secret_id, secret_key)
# 配置HTTP访问
httpProfile = HttpProfile()
httpProfile.endpoint = "iss.tencentcloudapi.com"
# 配置客户端
clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile
client = iss_client.IssClient(cred, "ap-guangzhou", clientProfile)
# 示例1：创建设备（GB28181协议）
def create_device():
req = models.AddUserDeviceRequest()
params = {
"DeviceName": "测试摄像头-01",
"ProtocolType": 1, # 1表示GB28181协议
"Description": "用于测试的GB28181设备"
}
req.from_json_string(json.dumps(params))
resp = client.AddUserDevice(req)
print("设备创建成功，设备ID：", resp.DeviceId)
return resp.DeviceId
# 示例2：查询设备详情
def describe_device(device_id):
req = models.DescribeUserDeviceRequest()
params = {
"DeviceId": device_id
}
req.from_json_string(json.dumps(params))
resp = client.DescribeUserDevice(req)
print("设备状态：", resp.Status) # 0:未注册 1:在线 2:离线 3:禁用
print("设备国标配置信息：", resp.GB28181Config)
return resp
# 示例3：创建录像上云计划
def create_record_plan(device_id, channel_id):
req = models.AddRecordPlanRequest()
params = {
"PlanName": "全天录像计划",
"PlanType": 1, # 1表示实时录像上云
"DeviceList": [
{
"DeviceId": device_id,
"ChannelId": channel_id
}
],
"RecordTemplateId": "模板ID", # 需要先创建录制模板
"LifeCycle": {
"StorageDays": 30 # 存储30天
}
}
req.from_json_string(json.dumps(params))
resp = client.AddRecordPlan(req)
print("录像计划创建成功，计划ID：", resp.PlanId)
return resp.PlanId
# 示例4：创建AI分析任务
def create_ai_task(device_id, channel_id):
req = models.CreateAITaskRequest()
params = {
"TaskName": "人员检测任务",
"TaskDesc": "检测视频中的人员出现情况",
"DeviceId": device_id,
"ChannelId": channel_id,
"AIType": "person_detect", # 具体的AI算法类型
"Status": "on" # on表示开启，off表示停止
}
req.from_json_string(json.dumps(params))
resp = client.CreateAITask(req)
print("AI任务创建成功，任务ID：", resp.TaskId)
return resp.TaskId
# 示例5：查询设备列表
def list_devices():
req = models.DescribeUserDeviceListRequest()
params = {
"PageNumber": 1,
"PageSize": 20
}
req.from_json_string(json.dumps(params))
resp = client.DescribeUserDeviceList(req)
for device in resp.DeviceList:
print(f"设备名称：{device.DeviceName}，状态：{device.Status}")
return resp
if __name__ == "__main__":
# 调用示例
device_id = create_device()
describe_device(device_id)
list_devices()
4.3 API Explorer工具
除了编写代码调用API外，腾讯云还提供了API Explorer工具，可以在线调用API并进行调试。以新增设备为例，进入API Explorer工具页面后，选择AddUserDevice接口，填写参数后即可在线调用。API Explorer会自动生成各语言的SDK代码，方便开发者快速集成。
五、录像管理：让视频数据有据可查
录像管理是智能视图计算平台的核心功能之一，主要包括录像计划、录像回放和录像下载三个维度。
5.1 录像上云计划
录像计划功能支持自定义选择视频通道及存储生命周期规则，核心解决"哪些设备在哪个时间段拉流上云并云存储多久"的问题。平台支持两种录像上云方式：
实时录像上云计划：拉取设备实时流进行上云存储。对于GB28181协议设备，还额外支持云端录像补录能力。实时上云模板可以预设设备上云的时间段，随后被应用于实时上云计划中。
本地录像上云计划：拉取设备本地录像流进行上云存储。录像上云模板的本质是"当日拉取昨日的设备本地录像上云"，适用于利用夜间或闲时充足的网络资源错峰拉流，确保录像完整上云。
5.2 录像回放与下载
云端录像回放支持时间轴进度拖拽、快/慢倍速播放。本地录像回放支持调阅设备端本地存储的录像。录像下载支持下载MP4、TS格式录像文件到本地。此外，平台还提供了录像健康度提示、单张/多张截图、音频播放、区域数字放大等特色功能。
对于存储在冷存储中的数据，平台支持云端录像取回功能，可以对冷存储类型的数据进行解冻回热，解冻后即可回放和下载。本地录像下载功能可以拉取所选时间段的设备本地录像上云进行云存储，同时也支持下载到用户客户端本地。
六、AI智能分析：让视频数据产生价值
智能视图计算平台集成了腾讯云领先的AI视觉算法，可以对上云数据进行目标识别、人员检测、行为分析等多场景的AI实时分析。平台具备多类别AI算法能力，包括目标识别、车辆车牌识别、人体识别、精彩集锦等。同时提供AI智能化应用和场景化算法定制服务，可针对性地帮助客户解决不同场景的业务需求。
6.1 AI任务配置
AI识别是对已通过录像计划功能拉流上云的数据进行分析。创建AI任务时需要指定任务名称、任务描述、设备ID、通道ID、AI算法类型以及任务状态（"on"表示开启，"off"表示停止）。
基于云端算法仓，平台支持部署自定义或第三方算法，大大加强了算法调度及托管能力。AI分析采用按需付费模式，避免了一次性前置投入。平台拥有充沛的算力资源和丰富的算法，支持单路流数据同时进行不同算法分析。算法模型可以无感升级，数据管理更加便捷。
6.2 AI应用场景
智能视图计算平台在多个行业场景中有着广泛的应用：智慧门店场景中，可将连锁门店分散的摄像头统一接入云端，进行设备集中管理、视频集中调阅和数据分层存储，同时结合客流统计、目标识别等算法分析，促进门店智能化升级。园区工地场景中，可以进行安全帽检测、人员违规行为识别等。明厨亮灶场景中，可以对后厨操作进行实时监控与合规性分析。
七、安全管理：保障视频数据安全
视频数据的安全性是用户最关心的问题之一，智能视图计算平台在多个层面提供了安全保障。
7.1 身份认证与权限管理
平台依托腾讯云访问管理CAM系统，对每个请求进行身份验证。开发者需要使用SecretId和SecretKey进行API调用鉴权。在权限管理方面，平台支持通过访问管理控制台创建子用户，实现最小权限授权。主账号可以创建自定义策略，精确控制子用户对平台资源的访问权限。建议使用RAM子账号进行日常操作，避免主账号密钥泄露的风险。
7.2 URL防盗链与数据加密
平台提供防盗链鉴权功能，防止流链接被窃取。URL鉴权配置采用时间戳防盗链方式，通过客户自定义密钥和有效时间生成token参数，并将其添加到所有推流和播流URL地址中，赋予地址一定的时效性。同时支持数据SSL加密传输，确保数据在传输过程中不丢失、不被窃取。服务配置中支持用户上传SSL数字证书，开启HTTPS数据加密访问。
7.3 水印配置
开启水印配置后，所有账号（含子账号）调阅的视频画面中均可带有水印内容，可确保数据安全。水印模板可以实现水印效果的预设，随后被应用于水印配置中。该功能目前以白名单方式供部分用户使用。
7.4 数据持久性与可用性
数据存储于腾讯云对象存储COS中，具备异地容灾和资源隔离功能，提供业界领先的数据持久性。存储可靠性达到99.999999999%（11个9），服务可用性达99.995%。
八、成本优化：让视频上云更经济
智能视图计算平台支持按量计费和包年包月两种计费方式。
8.1 计费模式
按量计费采用后付费日结模式，每日账单在第二天08:00左右生成。主要费用包括设备接入费用、云存储费用、网络流量费用以及AI识别服务费用。包年包月套餐包可以抵扣每日的实际用量，超出部分按照后付费计量计费并产生日结账单。
8.2 成本优化策略
按需拉流：平台支持按需拉流，点击通道开始拉流，关闭播放器停止拉流，有效防止网络过度消耗。按需录制：通过录像计划精确控制录制的时间和周期，避免不必要的存储浪费。自定义存储生命周期：将冷数据自动转换为低频或归档存储，或设置过期自动删除，进一步降低存储成本。
在概览页面可以查看昨日存储容量和网络消耗用量情况。当前计费方式支持自定义切换。上行和下行网络计费方式每日只可分别切换一次，并于凌晨0点生效。
8.3 网络计费方式
网络计费方式可在概览页面进行切换。需要注意的是，如果购买了预付费包年包月套餐包，包中的网络模式需要与控制台设置的网络模式保持一致，否则所购套餐包中的网络用量无法抵扣。
九、常见问题解答
问题1：智能视图计算平台支持哪些设备接入协议？
平台支持GB/T28181、RTMP、HTTP等标准协议直接接入。如果通过网关接入，还支持ONVIF协议以及海康SDK、大华SDK、宇视SDK等主流厂商私有协议。视音频编码协议支持H.264、H.265、G.711、AAC。传输协议支持UDP和TCP。流分发协议支持HTTP-FLV、RTMP、HLS。
问题2：设备添加后无法注册上线，如何排查？
首先检查设备端是否正确填写了平台提供的国标配置信息。然后通过DescribeUserDevice接口查询设备详情，查看Status字段。如果状态为0（未注册），说明设备端配置可能有误或网络不通。如果状态为2（离线），说明设备曾经注册成功但当前网络中断。如果状态为3（禁用），需要在控制台启用设备。
问题3：如何获取设备的播流地址？
在控制台的设备详情页面可以查看播流地址信息。平台会为每个视频通道生成HTTP-FLV、RTMP、HLS三种协议的实时播流地址。这些地址可以直接用于播放器集成或分发给终端用户观看。
问题4：录像上云计划配置后没有录像数据，是什么原因？
首先确认设备是否在线（Status为1）。然后检查录像计划中的设备ID和通道ID是否正确。确认录制模板中的时间段配置是否合理。最后检查存储生命周期规则是否配置正确。
问题5：AI分析任务创建后没有分析结果？
AI识别是对已通过录像计划功能拉流上云的数据进行分析。首先确认录像计划是否正常运行并有数据上云。然后检查AI任务状态是否为"on"。最后确认选择的AI算法类型是否支持当前视频内容。
问题6：如何估算使用成本？
可以使用腾讯云提供的价格计算器，自定义输入设备数量、存储时长、存储类型、AI分析路数等参数，即可计算出预估费用。主要费用包括设备接入费、存储费（按存储量计费）、网络流量费（外网下行流量）以及AI识别服务费。建议优先利用同地域内网访问免流量，将低频访问数据转为低频或归档存储以降低存储成本。
