创建流
描述
本接口用于创建流(用于接入类型非gb28181
的空间)
- 接口请求域名:
qvs.qiniuapi.com
- 请求方式:POST
- 接口路径:
/v1/namespaces/{namespaceId}/streams
请求参数
路径参数
参数名称 | 必填 | 字段类型 | 说明 |
---|---|---|---|
namespaceId | 是 | string | 空间ID |
Body
参数名称 | 必填 | 字段类型 | 说明 |
---|---|---|---|
streamId | 是 | string | 流名称, 流名称在空间中唯一,可包含 字母、数字、中划线、下划线;1 ~ 100 个字符长;创建后将不可修改 |
desc | 否 | string | 关于流的描述信息 |
recordTemplateId | 否 | string | 录制模版ID,配置流维度的录制模板,默认从空间继承 |
snapshotTemplateId | 否 | string | 截图模版ID,配置流维度的截图模板,默认从空间继承 |
aiTemplateId | 否 | string | AI模版ID,配置流维度的AI模板,默认从空间继承 |
pullType | 否 | string | 主动拉流模式的空间下,流的接入类型。rtsp/rtmp/http-flv/hls/other 拉流 |
pullAddr | 否 | string | 主动拉流模式的空间下,拉流地址 |
pullVideoModel | 否 | integer | 主动拉流模式的空间下,0代表视频源为实时流 1代表视频源为点播内容或静态文件 |
rtspModel | 否 | integer | 主动拉流模式的空间下,当拉流地址为rtsp时 0:代表udp拉流,1:代表tcp拉流。默认为0即udp |
响应参数
参数名称 | 类型 | 说明 |
---|---|---|
streamId | string | 流名称(流ID) |
desc | string | 描述 |
nsId | string | 所属的空间ID |
nsName | string | 所属的空间名称 |
recordTemplateId | string | 录制模版ID |
snapshotTemplateId | string | 截图模版ID |
aiTemplateId | string | AI模版ID |
disabled | boolean | 流是否被禁用 |
lastPushedAt | integer | 最后一次推流时间,0:表示流从创建开始尚未进行过推流操作 |
status | bool | 流是否在线 |
pullType | string | 主动拉流模式的空间下,流的接入类型。rtsp/rtmp/http-flv/hls/other 拉流 |
pullAddr | string | 主动拉流模式的空间下,拉流地址 |
createdAt | integer | 流创建时间 |
updatedAt | integer | 流更新时间 |
示例
请求示例
curl --request POST \
--url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams \
--header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
--header 'content-type: application/json' \
--data '{
"streamId":"device009",
"recordTemplateId":"d102sns2mwhd"
}'
响应示例
{
"streamId": "device009",
"nsId": "d102sni9zryu",
"nsName": "test009",
"recordTemplateId": "d102sns2mwhd",
"snapshotTemplateId": "",
"aiTemplateId": "",
"createdAt": 1586832470,
"updatedAt": 1586832470,
"status": false,
"disabled": false,
"lastPushedAt": 0
}
文档反馈
(如有产品使用问题,请 提交工单)