Object Storage Service:ライブトランスコーディングプレイリストの生成

1. ビデオのライブトランスコーディングプレイリストの生成

POST /example.avi?x-oss-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

x-oss-process=hls/m3u8,ss_15000,t_1800000,vcodec_h264,fps_25,fpsopt_1,s_1280x720,sopt_1,scaletype_fit,arotate_1,vb_2000000,vbopt_1,acodec_aac,ar_44100,ac_2,ab_128000,abopt_1,st_10000,initd_30000|sys/saveas,o_b3V0b2JqcHJlZml4L21lZGlh,b_b3V0YnVja2V0

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Wed, 25 May 2022 12:43:57 GMT
Content-Type: application/json;charset=utf-8
Content-Length: 161
Connection: keep-alive
x-oss-request-id: 628E2481184E20F26C000009
x-oss-transfer-acc-type: acc-none
x-oss-data-location: oss-cn-hangzhou-a
ETag: "D0F162350DA037F4DC2A142B2E116BD0"
Last-Modified: Wed, 25 May 2022 12:20:34 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: 2040549661341440100
x-oss-storage-class: Standard
x-oss-server-time: 12437

{"Duration":1800,"RequestId":"********-37E6-5996-8425-********","VideoPlaylist":[{"FrameRate":"25","Resolution":"1280x720","Token":"f93c43079**********1269608ebc86e","URI":"oss://outbucket/outobjprefix/media.m3u8"}]}

2. hls/sign を使用したライブトランスコーディングストリームへの署名

Object Storage Service (OSS) は、オーディオおよびビデオデータにアクセスするための動的署名メカニズムを提供します。m3u8 ファイルに初めてアクセスするときは、URL に x-oss-process=hls/sign,live_1 を追加します。すると、OSS は、m3u8 ファイルに使用されたのと同じ署名メソッドを使用して、返されたプレイリスト内のすべての TS アドレスに自動的に署名します。

• hls/sign 署名メソッド：

# -*- coding: utf-8 -*-
import os
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# バケットが配置されているリージョンのエンドポイントを指定します。実際の値に置き換えてください。
endpoint = 'yourEndpoint'

# 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# 宛先バケットの名前。
bucket_name = 'your-oss-bucket-name'
# key を生成されたプレイリストの名前に設定します (例：output/media.m3u8)。
key = 'output/media.m3u8'

# バケットインスタンスを指定します。すべてのファイル関連のメソッドは、バケットインスタンスを介して呼び出す必要があります。
# oss2.AuthV2 署名メソッドを使用する必要があります。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', bucket_name)

# x-oss-process の処理メソッドは hls/sign,live_1 です。
params = {}
params.update({oss2.Bucket.PROCESS: 'hls/sign,live_1'})

# 署名付き URL。
# 署名付き URL が生成される際、OSS はデフォルトでオブジェクトの完全なパスに含まれるスラッシュ (/) をエスケープします。これにより、署名付き URL が使用できなくなります。
# slash_safe を True に設定します。OSS はオブジェクトの完全なパスに含まれるスラッシュ (/) をエスケープしません。生成された署名付き URL は直接使用できます。
url = bucket.sign_url('GET', key, 7200, params=params, slash_safe=True)

# 生成された URL は HLS プレーヤーで直接再生できます。
print(url)

• 元の m3u8 コンテンツ

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-PLAYLIST-TYPE:VOD
#EXTINF:10.0,
media-c14709808479b31566b50f2f8b93fe1a-0.ts
#EXTINF:10.0,
media-c14709808479b31566b50f2f8b93fe1a-1.ts
#EXTINF:10.0,
media-c14709808479b31566b50f2f8b93fe1a-2.ts
#EXTINF:10.0,
media-c14709808479b31566b50f2f8b93fe1a-3.ts
#EXT-X-ENDLIST

• hls/sign で署名した後に返されるコンテンツ：

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-PLAYLIST-TYPE:VOD
#EXTINF:10.000,
media-c14709808479b31566b50f2f8b93fe1a-0.ts?x-oss-process=if_status_eq_404{hls/ts,from_b3V0cHV0L21lZGlhLm0zdTg}&x-oss-expires=1710457284&x-oss-signature-version=OSS2&x-oss-access-key-id=****fEAub****&x-oss-signature=****VR3gy****
#EXTINF:10.000,
media-c14709808479b31566b50f2f8b93fe1a-1.ts?x-oss-process=if_status_eq_404{hls/ts,from_b3V0cHV0L21lZGlhLm0zdTg}&x-oss-expires=1710457284&x-oss-signature-version=OSS2&x-oss-access-key-id=****fEAub****&x-oss-signature=****VR3gy****
#EXTINF:10.000,
media-c14709808479b31566b50f2f8b93fe1a-2.ts?x-oss-process=if_status_eq_404{hls/ts,from_b3V0cHV0L21lZGlhLm0zdTg}&x-oss-expires=1710457284&x-oss-signature-version=OSS2&x-oss-access-key-id=****fEAub****&x-oss-signature=****VR3gy****
#EXTINF:10.000,
media-c14709808479b31566b50f2f8b93fe1a-3.ts?x-oss-process=if_status_eq_404{hls/ts,from_b3V0cHV0L21lZGlhLm0zdTg}&x-oss-expires=1710457284&x-oss-signature-version=OSS2&x-oss-access-key-id=****fEAub****&x-oss-signature=****VR3gy****
#EXT-X-ENDLIST

どのような出力ファイルが含まれますか？

指定された出力パスのプレフィックスに基づいて、m3u8 ファイルと TS ファイルが生成されます。m3u8 ファイルはすぐに生成されます。事前トランスコーディング期間を指定した場合、その期間の TS ファイルが非同期で生成されます。たとえば、事前トランスコーディング期間が 30 秒でセグメントの長さが 10 秒の場合、3 つの TS ファイルが生成されます。事前トランスコーディングされていないビデオの部分は、再生中にオンデマンドでトランスコーディングされます。たとえば、ビデオが一度も再生されない場合、追加の TS ファイルは生成されません。ビデオを 15 分の時点から再生を開始すると、その時点からトランスコーディングが開始されます。生成されたファイルのディレクトリツリーは次のようになります。

.
├── outobjprefix.m3u8
├── outobjprefix-92376fbb-171f-4259-913f-705f7ee02f2s-0.ts
├── outobjprefix-92376fbb-171f-4259-913f-705f7ee02f2s-1.ts
├── outobjprefix-92376fbb-171f-4259-913f-705f7ee02f2s-2.ts
├── outobjprefix-92376fbb-171f-4259-913f-705f7ee02f2s-3.ts

生成された TS ファイルを手動で削除した後も、ビデオは正常に再生できますか？

はい、できます。ソースビデオファイルと m3u8 プレイリストが削除されない限り、ビデオは再生可能です。m3u8 プレイリストが再度リクエストされると、TS ファイルは再生成されます。この方法により、ビデオ再生に影響を与えることなくストレージコストを削減できます。

ライブトランスコーディングで生成されていない m3u8 ファイルをライブトランスコーディングに使用できますか？

いいえ、できません。ライブトランスコーディング機能で生成された m3u8 ファイルのみがライブトランスコーディングに使用できます。