437      阿裏雲

PutLiveChannel__關於LiveChannel的操作_API 參考_對象存儲 OSS-阿裏雲

通過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)

細節分析

1. ChannelName必須符合ObjectName的命名規範，另外，ChannelName不能包含”/“。
2. FragDuration和FragCount的默認值隻有在兩者都未指定時才會生效；指定了其中一個，則另一個的值也必須指定。
3. 轉儲類型為HLS時，OSS會在生成每個ts文件後，更新m3u8文件；m3u8文件中最多包含最近的FragCount個ts文件。
4. 轉儲類型為HLS時，寫入當前ts文件的音視頻數據時長達到FragDuration指定的時長後，OSS會在收到下一個關鍵幀的時候切換到下一個ts文件；如果max(2*FragDuration, 60s)後仍未收到下一個關鍵幀，OSS強製切換文件，此時可能引起播放時卡頓。

響應元素

細節分析

1. 推流地址是未加簽名的url，如果bucket acl非public-read-write，那麼需要首先進行簽名才能進行訪問。
2. 播放地址是未加簽名的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>https://test-bucket.oss-cn-hangzhou.aliyuncs.com/test-channel/playlist.m3u8</Url>
  </PlayUrls>
</CreateLiveChannelResult>