开发者社区 问答 正文

关于LiveChannel的操作之如何实现GetLiveChannelInfo?

本接口用来获取指定LiveChannel的配置信息。

请求语法GET /ChannelName?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue





响应元素

名称描述
LiveChannelConfiguration保存GetLiveChannelInfo返回结果的容器。类型:容器子节点:Description、Status、Target父节点:无
DescriptionLiveChannel的描述信息。类型:字符串子节点:无父节点:LiveChannelConfiguration
StatusLiveChannel的状态信息。类型:枚举字符串子节点:无父节点:LiveChannelConfiguration有效值:enabled、disabled
Target保存LiveChannel转储配置的容器。类型:容器子节点:Type、FragDuration、FragCount、PlaylistName父节点:LiveChannelConfiguration
Type当Type为HLS时,指定推流时转储文件类型。类型:枚举字符串子节点:无父节点:Target有效值:HLS
FragDuration当Type为HLS时,指定每个ts文件的时长(单位:秒)。类型:字符串子节点:无父节点: Target
FragCount当Type为HLS时,指定m3u8文件中包含ts文件的个数。类型:字符串子节点:无父节点:Target
PlaylistName当Type为HLS时,指定生成的m3u8文件的名称。类型:字符串子节点:无父节点:Target


细节分析


Target的子节点FragDuration,FragCount,PlaylistName只有当Type取值为HLS时才会返回。

示例



请求示例GET /test-channel?live HTTP/1.1
Date: Thu, 25 Aug 2016 05:52:40 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS YJjHKOKWDWINLKXv:D6bDCRXKht58hin1BL83wxyGvl0=





返回示例HTTP/1.1 200
content-length: 475
server: AliyunOSS
connection: close
x-oss-request-id: 57BE87A8B92475920B002098
date: Thu, 25 Aug 2016 05:52:40 GMT
content-type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<LiveChannelConfiguration>
  <Description></Description>
  <Status>enabled</Status>
  <Target>
    <Type>HLS</Type>
    <FragDuration>2</FragDuration>
    <FragCount>3</FragCount>
    <PlaylistName>playlist.m3u8</PlaylistName>
  </Target>
</LiveChannelConfiguration>



展开
收起
青衫无名 2017-10-23 10:14:17 1612 分享 版权
阿里云 AI 助理回答

要获取指定LiveChannel的配置信息,您需要使用阿里云OSS服务中的GetLiveChannelInfo接口。以下是操作指南和响应内容解析:

请求语法

发送一个HTTP GET请求到指定的Channel名称,结构如下:

GET /ChannelName?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
  • ChannelName:替换为您的实际Live Channel名称。
  • DateHostAuthorization:确保这些头部信息根据您的Bucket和访问密钥正确设置。

响应元素解析

响应将包含LiveChannel的详细配置信息,主要结构在LiveChannelConfiguration容器中,具体包括:

  • Description:LiveChannel的描述文本。
  • Status:LiveChannel的状态,有效值为enabled(启用)或disabled(禁用)。
  • Target:转储配置的容器,当Type为HLS时,会提供额外的子节点:
    • Type:文件类型,此处示例为HLS
    • FragDuration:每个ts片段的时长(秒)。
    • FragCount:m3u8文件中ts片段的数量。
    • PlaylistName:生成的m3u8文件名。

示例分析

请求示例

GET /test-channel?live HTTP/1.1
Date: Thu, 25 Aug 2016 05:52:40 GMTHost: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS YJjHKOKWDWINLKXv:D6bDCRXKht58hin1BL83wxyGvl0=

返回示例(XML格式):

<?xml version="1.0" encoding="UTF-8"?>
<LiveChannelConfiguration>
    <Description>enabled</Description>
    <Status>HLS</Status>
    <Target>
        <Type>HLS</Type>
        <FragDuration>2</FragDuration>
        <FragCount>3</FragCount>
        <PlaylistName>playlist.m3u8</PlaylistName>
    </Target>
</LiveChannelConfiguration>

此示例说明LiveChannel已启用,并配置为HLS类型,每个ts片段持续2秒,每个m3u8播放列表包含3个ts片段,且m3u8文件名为playlist.m3u8

请确保在调用接口前,Channel名称已正确填写且符合要求,避免因为空字符串导致的错误。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答