天翼云智能视图服务API

1.本地录像回放控制

接口功能介绍

本接口用于本地录像回放控制，支持播放、暂停、跳转和倍速。

接口约束

调用本接口前，先请求“查询设备本地历史流”接口获取流播放地址。重新获取设备的流播放地址后，之前的流播放地址将失效。暂停操作后，流和播放器的保活时间为300秒。

URI

PUT /devices/{DeviceId}/records/localRecordPlay

路径参数

参数	是否必填	参数类型	说明	示例	下级对象
DeviceId	是	String	设备ID。	978157687617634304

Query参数
无

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例
Authorization	是	String	认证信息。	CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f
Content-Type	是	String	互联网媒体类型。	application/json;charset=utf-8
Host	是	String	主机。	vssapi.ctyun.cn
Version	是	String	版本。	2021-11-25
Timestamp	是	String	时间戳。	1689643309

请求体body参数

参数	是否必填	参数类型	说明	示例
PlayUrl	是	String	录像播放地址。	http://example.ctyun.cn/example
Method	否	String	操作方法。取值：play（播放），pause（暂停）。	play
Range	否	Integer	录像起点的相对值。单位为秒，用于跳转。	1000
Scale	否	Double	倍速。取值：0.25，0.5，1.0，1.5，2.0，4.0，8.0，16.0。	2.0

响应参数

参数	参数类型	说明	示例	下级对象
statusCode	Integer	响应状态码。	200
error	String	错误码，执行成功时，不返回该字段。	VSS_0001
message	String	响应信息。	请求成功
requestId	String	请求ID。	362d4e78556b47129182d0881fade86b
returnObj	Object	响应数据，执行失败时，不返回该字段。		returnObj

表 returnObj

参数	参数类型	说明	示例	下级对象
RequestId	String	请求ID。	362d4e78556b47129182d0881fade86b

请求示例

请求url

PUT '/devices/978157687617634304/records/localRecordPlay'

请求头header

{
  "Authorization": "CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f",
  "Content-Type": "application/json;charset=utf-8",
  "Host": "vssapi.ctyun.cn",
  "Version": "2021-11-25",
  "Timestamp": "1689643309"
}

请求体body

{
  "PlayUrl": "http://example.ctyun.cn/example",
  "Method": "play"
}

响应示例

{
  "statusCode": 200,
  "message": "请求成功",
  "requestId": "362d4e78556b47129182d0881fade86b",
  "returnObj": {
    "RequestId": "362d4e78556b47129182d0881fade86b"
  }
}

状态码

请参考状态码说明。

错误码

请参考错误码说明。

本地录像回放控制

最近更新时间：2026-03-19 18:16:28