通過ListMediaLiveChannels API分頁查詢媒體直播頻道 - 智能媒體服務

查詢媒體直播頻道列表。

介面說明

調用本介面查詢媒體直播頻道列表。

QPS 限制

本介面的單使用者 QPS 限制為 50 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:ListMediaLiveChannels

list

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
MaxResults	integer	否	分頁查詢時每頁行數。最大值為 100。預設值：當不設定值或設定的值小於 10 時，預設值為 10。當設定的值大於 100 時，預設值為 100。	10
Skip	integer	否	分頁查詢時跳過的條目數。當跳過的條目數超過合格條目總數時，會返回空列表。	20
NextToken	string	否	查詢憑證（Token），取值為上一次 API 呼叫返回的 NextToken 參數值。	caeba0bbb2be03f84eb48b699f0a4883
SortOrder	string	否	指定定序，用於按頻道的建立時間排序。預設是 asc。可選值：desc（降序排序），asc（升序排序）。	desc
Keyword	string	否	指定查詢的關鍵詞。對頻道 ID/名稱進行搜尋，均支援模糊搜尋。	123
States	string	否	指定查詢的頻道狀態，可以由多個頻道狀態組成一個 JSON 數組，狀態值之間用半形逗號（,）隔開。	["IDLE","RUNNING"]

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	請求 ID。	****11-DB8D-4A9A-875B-275798****
Channels	array<object>	頻道配置列表
	array<object>
ChannelId	string	頻道 ID。	SEGK5KA6KYKAWQQH
Name	string	頻道名稱。	mych
State	string	頻道狀態。可能的傳回值包括：IDLE（空閑中）, STARTING（啟動中）, RUNNING（運行中）, RECOVERING（恢複中）， STOPPING（停止中）。	IDLE
InputAttachments	array<object>	輸入綁定設定。
	array<object>
InputId	string	綁定的輸入 ID。	SEGK5KA6KYKAWQQH
InputName	string	輸入名稱。	myinput
LanguageName	string	語言名稱。	eng
AudioSelectors	array<object>	音頻選取器列表。
	array<object>
Name	string	音頻選取器名稱。	myselector
AudioLanguageSelection	object	語言選取器。
LanguageCode	string	ISO639-2 語言代碼。3 字元。	eng
AudioPidSelection	object	P識別碼選取器。
Pid	integer	輸入源流的 Pid。	123
AudioTrackSelection	array<object>	track 選取器。
	object
TrackId	integer	輸入源流的 TrackId。	1
OutputGroups	array<object>	輸出組配置。
	array<object>
Name	string	輸出組名稱。	group1
Type	string	輸出群組類型。	MediaPackage
Outputs	array<object>	輸出資料行表設定。
	array<object>
Name	string	輸出名稱。	output1
MediaType	integer	輸出的媒體類型。	0
MediaPackageOutputSetting	object	輸出群組類型為 MediaPackage 時的輸出設定。
NameModifier	string	manifest 尾碼。	480p
AudioGroupId	string	manifest 音頻組 id 設定。	audiogroup
VideoSettingName	string	引用的視頻設定名稱。	myVideo1
AudioSettingNames	array	引用的音頻設定名稱列表。
	string	引用的音頻設定名稱。	myAudio1
MediaPackageGroupSetting	object	輸出群組類型為 MediaPackage 時的輸出組設定。
GroupName	string	引用的 MediaPackage 的 GroupName。	myPackageGroup
ChannelName	string	引用的 MediaPackage 的 ChannelName。	myPackageChannel
MonitorUrl	string	輸出組監看地址，用於監播。僅當輸出群組類型為 MediaPackage 類型，查詢頻道詳情時會返回輸出組監看地址。	rtmp://xxx
AudioSettings	array<object>	音頻設定。
	array<object>
Name	string	音頻設定名稱。	zhuanfengzhuang
AudioSelectorName	string	音頻選取器名稱。	myselector
LanguageCode	string	ISO639-2 語言代碼，3 字元。	eng
LanguageName	string	語言名稱。	English
AudioCodec	string	音頻編碼類別型。	aac
AudioCodecSetting	object	音頻編碼設定。
Profile	string	音頻編碼層級。	AAC-LOW
Bitrate	integer	音頻位元速率。	200000
SampleRate	integer	音頻採樣率。	44100
VideoSettings	array<object>	視頻設定。
	array<object>
Name	string	視頻設定名稱。	video1
Width	integer	視頻解析度寬。	1280
Height	integer	視頻解析度高。	720
VideoCodec	string	視頻編碼類別型。	H264
VideoCodecSetting	object	視頻編碼設定。
Rate	object	視頻編碼速率設定。
Bitrate	integer	視頻位元速率。	2500000
RateControlMode	string	視頻編碼碼控規則。	ABR
MaxBitrate	integer	視頻編碼最大位元速率。	6000000
BufferSize	integer	視頻編碼緩衝區大小。	6000000
Framerate	object	視訊框架率設定。
FramerateControl	string	視訊框架率設定模式。	SPECIFIED
FramerateNumerator	integer	視訊框架率分子。	25
FramerateDenominator	integer	視訊框架率分母。	1
Gop	object	視頻 GOP 設定。
GopSizeUnits	string	視頻 GOP 長度單位。	FRAMES
GopSize	integer	視頻 GOP 大小。	90
BframesNum	integer	B 幀數。	3
CodecDetail	object	視頻編碼詳情設定。
Profile	string	視頻編碼配置。	MAIN
Level	string	視頻編碼層級。暫不支援。	H264_LEVEL_AUTO
VideoCodecType	string	視頻轉碼方式（普通轉碼、窄帶高清轉碼等）	NORMAL
CreateTime	string	頻道建立時間，格式為：yyyy-MM-ddTHH:mm:ssZ（RFC 3339 格式），採用 UTC +0 時區。	2024-12-03T06:56:42Z
LastStartTime	string	頻道最近一次啟動時間，格式為：yyyy-MM-ddTHH:mm:ssZ（RFC 3339 格式），採用 UTC +0 時區。如果頻道建立後從未啟動過，則返回Null 字元串。	2024-12-03T06:56:42Z
LastStopTime	string	頻道最近一次停止時間，格式為：yyyy-MM-ddTHH:mm:ssZ（RFC 3339 格式），採用 UTC +0 時區。如果頻道建立後從未停止過，則返回Null 字元串。	2024-12-03T06:56:42Z
MaxResults	integer	分頁查詢時每頁行數。	10
NextToken	string	查詢憑證。	caeba0bbb2be03f84eb48b699f0a4883
TotalCount	integer	符合分頁條件查詢的總條目數。	100

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Channels": [
    {
      "ChannelId": "SEGK5KA6KYKAWQQH",
      "Name": "mych",
      "State": "IDLE",
      "InputAttachments": [
        {
          "InputId": "SEGK5KA6KYKAWQQH",
          "InputName": "myinput",
          "LanguageName": "eng",
          "AudioSelectors": [
            {
              "Name": "myselector",
              "AudioLanguageSelection": {
                "LanguageCode": "eng"
              },
              "AudioPidSelection": {
                "Pid": 123
              },
              "AudioTrackSelection": [
                {
                  "TrackId": 1
                }
              ]
            }
          ]
        }
      ],
      "OutputGroups": [
        {
          "Name": "group1",
          "Type": "MediaPackage",
          "Outputs": [
            {
              "Name": "output1",
              "MediaType": 0,
              "MediaPackageOutputSetting": {
                "NameModifier": "480p",
                "AudioGroupId": "audiogroup"
              },
              "VideoSettingName": "myVideo1",
              "AudioSettingNames": [
                "myAudio1"
              ]
            }
          ],
          "MediaPackageGroupSetting": {
            "GroupName": "myPackageGroup",
            "ChannelName": "myPackageChannel"
          },
          "MonitorUrl": "rtmp://xxx"
        }
      ],
      "AudioSettings": [
        {
          "Name": "zhuanfengzhuang",
          "AudioSelectorName": "myselector",
          "LanguageCode": "eng",
          "LanguageName": "English",
          "AudioCodec": "aac",
          "AudioCodecSetting": {
            "Profile": "AAC-LOW",
            "Bitrate": 200000,
            "SampleRate": 44100
          }
        }
      ],
      "VideoSettings": [
        {
          "Name": "video1",
          "Width": 1280,
          "Height": 720,
          "VideoCodec": "H264",
          "VideoCodecSetting": {
            "Rate": {
              "Bitrate": 2500000,
              "RateControlMode": "ABR",
              "MaxBitrate": 6000000,
              "BufferSize": 6000000
            },
            "Framerate": {
              "FramerateControl": "SPECIFIED",
              "FramerateNumerator": 25,
              "FramerateDenominator": 1
            },
            "Gop": {
              "GopSizeUnits": "FRAMES",
              "GopSize": 90,
              "BframesNum": 3
            },
            "CodecDetail": {
              "Profile": "MAIN",
              "Level": "H264_LEVEL_AUTO"
            }
          },
          "VideoCodecType": "NORMAL"
        }
      ],
      "CreateTime": "2024-12-03T06:56:42Z",
      "LastStartTime": "2024-12-03T06:56:42Z",
      "LastStopTime": "2024-12-03T06:56:42Z"
    }
  ],
  "MaxResults": 10,
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "TotalCount": 100
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。