关于LiveChannel的操作之如何实现PutLiveChannel？
通过RTMP协议上传音视频数据前，必须先调用该接口来创建一个LiveChannel。该接口会返回RTMP推流地址，以及对应的播放地址。用户可以使用返回的地址进行推流、播放。另外，用户可以根据该LiveChannel的名称来发起相关的操作，如查询推流状态、查询推流记录、禁止推流等。
请求语法PUT /ChannelName?live HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT date
Content-Length: Size
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<LiveChannelConfiguration>
<Description>ChannelDescription</Description>
<Status>ChannelStatus</Status>
<Target>
<Type>HLS</Type>
<FragDuration>FragDuration</FragDuration>
<FragCount>FragCount</FragCount>
<PlayListName>PlaylistName</PlayListName>
</Target>
</LiveChannelConfiguration>
请求元素(Request Elements)
| 名称 | 描述 | 是否必需 |
| LiveChannelConfiguration | 保存LiveChannel配置的容器。类型：容器 子节点：Description、Status、Target父节点：无 | 是 |
| Description | LiveChannel的描述信息，最长128字节。类型：字符串 子节点：无父节点：LiveChannelConfiguration | 否 |
| Status | 指定LiveChannel的状态。类型：枚举字符串子节点：无父节点：LiveChannelConfiguration有效值：enabled、disabled | 否默认值：enabled |
| Target | 保存转储配置的容器。类型：容器子节点：Type、FragDuration、FragCount、PlaylistName父节点：LiveChannelConfiguration | 是 |
| Type | 指定转储的类型。类型：枚举字符串子节点：无父节点：Target有效值：HLS | 是 |
| FragDuration | 当Type为HLS时，指定每个ts文件的时长（单位：秒），取值范围为[1, 100]的整数。类型：字符串子节点：无父节点: Target | 否默认值：5 |
| FragCount | 当Type为HLS时，指定m3u8文件中包含ts文件的个数，取值范围为[1, 100]的整数。类型：字符串子节点：无父节点：Target | 否默认值: 3 |
| PlaylistName | 当Type为HLS时，指定生成的m3u8文件的名称，必须以”.m3u8”结尾，长度范围为[6, 128]。类型：字符串子节点：无父节点：Target | 否默认值：playlist.m3u8 |
细节分析
- ChannelName必须符合ObjectName的命名规范，另外，ChannelName不能包含”/“。
- FragDuration和FragCount的默认值只有在两者都未指定时才会生效；指定了其中一个，则另一个的值也必须指定。
- 转储类型为HLS时，OSS会在生成每个ts文件后，更新m3u8文件；m3u8文件中最多包含最近的FragCount个ts文件。
- 转储类型为HLS时，写入当前ts文件的音视频数据时长达到FragDuration指定的时长后，OSS会在收到下一个关键帧的时候切换到下一个ts文件；如果max(2*FragDuration, 60s)后仍未收到下一个关键帧，OSS强制切换文件，此时可能引起播放时卡顿。
响应元素
| 名称 | 描述 |
| CreateLiveChannelResult | 保存CreateLiveChannel请求结果的容器。类型：容器子节点：PublishUrls,PlayUrls父节点：无 |
| PublishUrls | 保存推流地址的容器。类型：容器子节点：Url父节点：CreateLiveChannelResult |
| Url | 推流地址。类型：字符串子节点：无父节点：PublishUrls |
| PlayUrls | 保存推流地址的容器。类型：容器子节点：Url父节点：CreateLiveChannelResult |
| Url | 播放地址。类型：字符串子节点：无父节点：PlayUrls |
细节分析
- 推流地址是未加签名的url，如果bucket acl非public-read-write，那么需要首先进行签名才能进行访问。
- 播放地址是未加签名的url，如果bucket acl为private，那么需要首先进行签名才能进行访问。
实例
请求示例
PUT /test-channel?live HTTP/1.1
Date: Wed, 24 Aug 2016 11:11:28 GMT
Content-Length: 333
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS YJjHKOKWDWINLKXv:hvwOZJRh8toAj3DZvtsuPgf+agA=
<?xml version="1.0" encoding="utf-8"?>
<LiveChannelConfiguration>
<Description/>
<Status>enabled</Status>
<Target>
<Type>HLS</Type>
<FragDuration>2</FragDuration>
<FragCount>3</FragCount>
</Target>
</LiveChannelConfiguration>返回示例
HTTP/1.1 200
content-length: 259
server: AliyunOSS
x-oss-server-time: 4
connection: close
x-oss-request-id: 57BD8419B92475920B0002F1
date: Wed, 24 Aug 2016 11:11:28 GMT
x-oss-bucket-storage-type: standard
content-type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<CreateLiveChannelResult>
<PublishUrls>
<Url>rtmp://test-bucket.oss-cn-hangzhou.aliyuncs.com/live/test-channel</Url>
</PublishUrls>
<PlayUrls>
<Url>http://test-bucket.oss-cn-hangzhou.aliyuncs.com/test-channel/playlist.m3u8</Url>
</PlayUrls>
</CreateLiveChannelResult>
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
