用於添加即時資料流媒體頻道的來源站點端點配置,支援HLS、HLS_CMAF和DASH協議及DRM加密。
介面說明
請求說明
該介面允許使用者建立一個即時打包服務的來源站點端點,主要用於配置頻道的回源、安全性原則(如 IP 黑白名單及授權碼)及時移功能。目前僅支援 HLS 協議播放。建立來源站點端點前,需先建立好即時打包頻道組和頻道。建立成功後,將返回端點播放地址及其他配置詳情。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ice:CreateLivePackageOriginEndpoint |
create |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| GroupName |
string |
是 |
頻道組名稱 |
channel-group-1 |
| ChannelName |
string |
是 |
頻道名稱 |
channel-1 |
| EndpointName |
string |
是 |
來源站點端點名稱,字元必須為大小寫英文字母、數字、虛線、底線。1 ~ 200 個字元。格式:[A-Za-z0-9_-]+ |
endpoint-1 |
| Protocol |
string |
是 |
分發協議 |
HLS |
| ManifestName |
string |
否 |
清單名稱,預設 manifest |
manifest |
| Description |
string |
否 |
端點描述 |
這是一個來源站點端點 |
| TimeshiftVision |
integer |
否 |
時移天數,最大 30 天,預設為 0 表示不支援時移 |
1 |
| AuthorizationCode |
string |
否 |
授權碼,與 IpWhitelist 至少設定一個,最長 200 字元。格式:[A-Za-z0-9-_.]+ |
AbcDef123 |
| IpWhitelist |
string |
否 |
IP 白名單,支援掩碼,不允許配置 0.0.0.0/0,多個使用逗號分隔,與 AuthorizationCode 至少設定一個,最大 1000 字元 |
192.168.1.0/24,10.0.0.1/24 |
| IpBlacklist |
string |
否 |
IP 黑名單,支援掩碼,不允許配置 0.0.0.0/0,多個使用逗號分隔,最大 1000 字元 |
103.21.222.1/32,192.168.100.0/24 |
| ClientToken |
string |
否 |
等冪參數 |
****0311a423d11a5f7dee713535**** |
| LivePackagingConfig | LivePackagingConfig |
否 |
直播封裝配置 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| LivePackageOriginEndpoint |
object |
LivePackageOriginEndpoint 類型 |
|
| AuthorizationCode |
string |
授權碼 |
Abcded123 |
| ChannelName |
string |
頻道名稱 |
channel-1 |
| CreateTime |
string |
建立時間 |
2023-04-01T12:00:00Z |
| Description |
string |
端點描述 |
這是一個來源站點端點 |
| EndpointName |
string |
端點名稱 |
endpoint-1 |
| EndpointUrl |
string |
端點播放地址 |
https://xxx.packagepull-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest |
| GroupName |
string |
頻道組名稱 |
channel-group-1 |
| IpBlacklist |
string |
IP 黑名單 |
103.21.222.1/32,192.168.100.0/24 |
| IpWhitelist |
string |
IP 白名單 |
192.168.1.0/24,10.0.0.1/24 |
| LastModified |
string |
最後修改時間 |
2023-04-01T12:00:00Z |
| ManifestName |
string |
清單名稱 |
manifest |
| Protocol |
string |
協議,暫只支援 HLS |
HLS |
| TimeshiftVision |
integer |
時移天數,最大 30 天 |
1 |
| LivePackagingConfig | LivePackagingConfig |
直播封裝配置 |
|
| RequestId |
string |
請求 ID |
******11-DB8D-4A9A-875B-275798****** |
樣本
正常返回樣本
JSON格式
{
"LivePackageOriginEndpoint": {
"AuthorizationCode": "Abcded123",
"ChannelName": "channel-1",
"CreateTime": "2023-04-01T12:00:00Z",
"Description": "這是一個來源站點端點",
"EndpointName": "endpoint-1",
"EndpointUrl": "https://xxx.packagepull-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest",
"GroupName": "channel-group-1",
"IpBlacklist": "103.21.222.1/32,192.168.100.0/24",
"IpWhitelist": "192.168.1.0/24,10.0.0.1/24",
"LastModified": "2023-04-01T12:00:00Z",
"ManifestName": "manifest",
"Protocol": "HLS",
"TimeshiftVision": 1,
"LivePackagingConfig": {
"LiveManifestConfigs": [
{
"SegmentCount": 3,
"AdMarkers": "NONE",
"MinVideoBitrate": 1000000,
"MinBufferTime": 8,
"PresentationDelay": 12,
"StreamOrder": "ORIGINAL",
"MaxVideoBitrate": 8000000,
"DateTimeInterval": 5,
"SegmentTemplateFormat": "NUMBER_TIMELINE",
"MinUpdatePeriod": 8,
"ManifestDuration": 60
}
],
"UseAudioRenditionGroups": true,
"DrmConfig": {
"SystemIds": [
"9a04f079-9840-4286-ab92-e65be0885f95"
],
"RotatePeriod": 0,
"ContentId": "live-axb1-9dd2fa123",
"EncryptionMethod": "SAMPLE_AES",
"IV": "00000000000000000000000000000000",
"Url": "https://exampledrm.com/path?arg1=xxx"
},
"SegmentDuration": 6
}
},
"RequestId": "******11-DB8D-4A9A-875B-275798******"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。