全部產品
Search
文件中心

Intelligent Media Services:CreateLivePackageChannel - 建立即時打包頻道

更新時間:Mar 21, 2026

產生即時視頻流處理頻道,支援HLS協議,自動分配端點和密鑰。

介面說明

請求說明

該介面用於建立一個即時視頻打包服務頻道,目前支援 HLS 協議。系統將自動產生輸入端點地址及認證所需的使用者名稱和密碼。

注意事項

  • 頻道組名稱與頻道名稱只能包含大小寫字母、數字、底線和虛線。

  • 協議目前僅支援HLS

  • 切片時間長度需設定在 1 至 30 秒之間。

  • m3u8 切片個數需在 2 至 100 個之間。

成功響應將返回新建立頻道的詳細資料,包括通道名、建立時間、修改時間、輸入端點詳情等。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:CreateLivePackageChannel

create

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

GroupName

string

頻道組名稱,字元必須為大小寫英文字母、數字、虛線、底線。1 ~ 200 個字元。格式:[A-Za-z0-9_-]+

channel-group-1

SegmentCount

integer

輸入資料流 m3u8 切片個數,2~100

3

Description

string

描述,最大 1000 個字元

這是一個測試頻道

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

描述

這是一個測試頻道

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": "這是一個測試頻道",
    "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******"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情