產生即時影片串流處理頻道,支援 HLS 通訊協定,自動分配端點和金鑰。
介面說明
請求說明
此介面用於建立一個即時影片打包服務頻道,目前支援 HLS 通訊協定。系統將自動產生輸入端點位址及驗證所需的使用者名稱和密碼。
注意事項
頻道群組名稱與頻道名稱只能包含大小寫字母、數字、底線和連字號。
通訊協定目前僅支援
HLS。切片時長需設定在 1 至 30 秒之間。
m3u8 切片數量需在 2 至 100 個之間。
成功回應將傳回新建立頻道的詳細資訊,包括通道名稱、建立時間、修改時間、輸入端點詳情等。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| GroupName |
string |
是 |
頻道群組名稱,字元必須為大小寫英文字母、數字、連字號、底線。1 ~ 200 個字元。格式:[A-Za-z0-9_-]+ |
channel-group-1 |
| SegmentCount |
integer |
是 |
輸入串流 m3u8 切片數量,2~100 |
3 |
| Description |
string |
否 |
描述,最大 1000 個字元。 |
This is a test channel. |
| SegmentDuration |
integer |
是 |
輸入串流切片時長,1~30 |
6 |
| ChannelName |
string |
是 |
頻道名稱,字元必須為大小寫英文字母、數字、連字號、底線。1 ~ 200 個字元。格式:[A-Za-z0-9_-]+ |
channel-1 |
| ClientToken |
string |
否 |
冪等參數。 |
****12e8864746a0a398**** |
| Protocol |
string |
是 |
輸入通訊協定,目前僅支援 HLS。 |
HLS |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| LivePackageChannel |
object |
即時打包頻道的具體資訊。 |
|
| ChannelName |
string |
頻道名稱。 |
example-channel |
| CreateTime |
string |
格式:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。 |
2023-04-01T12:00:00Z |
| Description |
string |
描述。 |
This is a test channel. |
| GroupName |
string |
頻道群組名稱。 |
channel-group-1 |
| IngestEndpoints |
array<object> |
輸入端點。 |
|
|
object |
輸入端點 URL。 |
||
| Id |
string |
輸入端點 ID |
ingest1 |
| Password |
string |
密碼 |
2F9e******b569c8 |
| Url |
string |
輸入端點 URL |
http://xxx-1.packagepush-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest |
| Username |
string |
使用者名稱 |
us12******das |
| LastModified |
string |
格式:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。 |
2023-04-01T12:00:00Z |
| Protocol |
string |
輸入通訊協定,HLS。 |
HLS |
| SegmentCount |
integer |
輸入串流 m3u8 切片數量。 |
3 |
| SegmentDuration |
integer |
輸入串流切片時長。 |
5 |
| RequestId |
string |
請求 ID。 |
******3B-0E1A-586A-AC29-742247****** |
樣本
正常返回樣本
JSON格式
{
"LivePackageChannel": {
"ChannelName": "example-channel",
"CreateTime": "2023-04-01T12:00:00Z",
"Description": "This is a test channel.",
"GroupName": "channel-group-1",
"IngestEndpoints": [
{
"Id": "ingest1",
"Password": "2F9e******b569c8",
"Url": "http://xxx-1.packagepush-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest",
"Username": "us12******das"
}
],
"LastModified": "2023-04-01T12:00:00Z",
"Protocol": "HLS",
"SegmentCount": 3,
"SegmentDuration": 5
},
"RequestId": "******3B-0E1A-586A-AC29-742247******"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。