为指定发布点设置预置的转码模版。
PATCH https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/{entry_point}/settings/transcode/standard/{name}
参数 | 类型 | 描述 |
---|---|---|
appid |
String | 必填。在声网控制台获取的 App ID。 |
entry_point |
String | 必填。发布点名称。 |
name |
String | 必填。预置转码模版的名称,详见下表。 |
预置转码模版
name |
预置转码模版 | 分辨率 | 视频码率(kbps) | 编码格式 |
---|---|---|---|---|
ld |
流畅 | 高度 240,宽度自适应 | 400 | H.264 |
sd1 |
标清一 | 高度 360,宽度自适应 | 640 | H.264 |
sd2 |
标清二 | 高度 480,宽度自适应 | 800 | H.264 |
sd3 |
标清三 | 高度 540,宽度自适应 | 1,200 | H.264 |
hd |
高清 | 高度 720,宽度自适应 | 1,500 | H.264 |
fhd |
超清 | 高度 1080,宽度自适应 | 2,100 | H.264 |
请求包体为 JSON Object 类型,包含以下字段:
enabled
:Boolean 型,必填。是否启用转码模版。true
:启用转码模版。false
:不启用转码模版。advancedTranscode
:Boolean 型,选填。是否启用低码高清服务。低码高清服务可以在主观画质不受影响的前提下平均降低 50% 码率,详见低码高清产品概述。true
:启用低码高清。false
:不启用低码高清。如果返回的 HTTP 状态码为 200,表示请求成功。
如果返回的 HTTP 状态码非 200,表示请求失败。你可以参考 HTTP 状态码了解可能的原因。
请求行
PATCH https://api.sd-rtn.com/v1/projects/{your_appid}/fls/entry_points/live/settings/transcode/standard/sd1 HTTP/1.1
请求 body
{
"enabled": true,
"advancedTranscode": true
}
响应行
HTTP/1.1 200 OK
获取指定发布点的转码模版列表。
GET https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/{entry_point}/settings/transcode/standard
参数 | 类型 | 描述 |
---|---|---|
appid |
String | 必填。在声网控制台获取的 App ID。 |
entry_point |
String | 必填。发布点名称。 |
如果返回的 HTTP 状态码为 200,表示请求成功,响应包体中包含以下字段:
transcodeList
: JSON Array 型,转码模版列表。一个转码模版对应一个 JSON Object,包含以下字段:
字段 | 类型 | 描述 |
---|---|---|
name |
String | 转码模版的名称。 |
enabled |
Boolean | 转码模版是否已启用。 |
advancedTranscode |
Boolean | 低码高清服务是否已启用。 |
如果返回的 HTTP 状态码非 200,表示请求失败。你可以参考 HTTP 状态码了解可能的原因。
请求行
GET https://api.sd-rtn.com/v1/projects/{your_appid}/fls/entry_points/live/settings/transcode/standard HTTP/1.1
响应行
HTTP/1.1 200 OK
响应 body
{
"transcodeList": [
{
"enabled": true,
"name": "sd1",
"advancedTranscode": true
},
{
"enabled": true,
"name": "sd2",
"advancedTranscode": true
},
{
"enabled": true,
"name": "sd3",
"advancedTranscode": false
}
]
}
状态码 | 描述 |
---|---|
200 | 请求成功。 |
400 | 参数非法,如 appid 或者 name 为空。 |
401 | 未经授权的(客户 ID/客户密钥匹配错误)。 |
404 | 服务器无法根据请求找到资源,即请求的发布点不存在,或者请求的 URI 路径非法。 |
500 | 服务器内部错误,无法完成请求。 |
504 | 服务器内部错误。充当网关或代理的服务器未从远端服务器获取请求。 |