2.5、实时录视频

录制视频为异步操作，即发起录制请求后，视频将以事件的形式通知到开发者服务器。

POSThttps://open.eye4cloud.com/{{open_id}}/open/v1/realtime/getVideo
请求数据
字段名 是否必传 类型 备注
device_id 是 string 设备id
timestamp 是 int64 时间戳，单位：秒
nonce 是 string 随机字符串，8~20个字符
sign 是 string 具体实现方法，请参考《生成sign的示例代码》
second 否 int 最低5秒，最大30秒
password 否 string 设备密码，如果不传则使用开放平台中注册设备的密码
uuid 否 string 请求id，截图/录像后返回（主要用于异步请求和响应）
async 否 bool 是否异步，只有异步（true）才会使用回调
JSON
{
  "uuid": "请求id",
  "list": [
    {
      "file": "http://127.0.0.1/aaa.mp4",
      "filename": "文件名",
      "file_type":1, // 0图片，1视频
    }
  ]
}
callback_urls 否 array 异步时使用，回调url,最多支持3个
data 否 string 设备DATA，可传空字符串
imei 否 string 设备IMEI，可传空字符串
CURL请求示例
CURL
curl 'https://open.eye4cloud.com/{{open_id}}/open/v1/realtime/getVideo' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "DEMO_DEVICE_001",
    "timestamp": 1758867195,
    "nonce": "",
    "sign": "",
    "imei": "",
    "data": "",
    "second":10,
    "password": "",
    "uuid": "u1u1",
    "async": false,
    "callback_urls": []
}'
返回数据
字段名 类型 备注
error_code int 状态码：0正常，其他异常
error_message string 错误信息：正常为success
data object 同步请求时结果
uuid string 请求id
list array 结果列表
file string 图片/视频文件链接
filename string 文件名
file_type int 文件类型：0图片，1视频

示例：

JSON
{
    "error_code": 0,
    "error_message": "success",
    "error_tips": "",
    "data": {
        "uuid": "",
        "list": [
            {
                "file": "文件base64数据",
                "filename": "文件名",
                "file_type": 1
            }
        ]
    }
}