コンテンツにスキップ

始める

最初の動画をアップロード

ステップ1: 公開URLからのサンプル動画をアップロード

Cloudflareダッシュボードから直接動画をアップロードするか、APIを使用してアップロードできます。

APIを使用する場合は、以下の例でAPI_TOKENACCOUNT_IDの値をあなたの認証情報に置き換えてください。

APIを使用して動画をアップロード
curl \
-X POST \
-d '{"url":"https://storage.googleapis.com/stream-example-bucket/video.mp4","meta":{"name":"My First Stream Video"}}' \
-H "Authorization: Bearer <API_TOKEN>" \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/copy

ステップ2: 動画がストリーミング可能になるまで待つ

Streamは動画をダウンロードして処理する必要があるため、動画の長さに応じて数秒間利用できない場合があります。readyToStreamtrueになるまでStream APIをポーリングするか、ウェブフックを使用して動画がストリーミング可能になったときに通知を受け取ることができます。

最初のステップからの動画UIDを使用して動画をポーリングします:

リクエスト
curl \
-H "Authorization: Bearer <API_TOKEN>" \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/<VIDEO_UID>
レスポンス
{
"result": {
"uid": "6b9e68b07dfee8cc2d116e4c51d6a957",
"preview": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/watch",
"thumbnail": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/thumbnails/thumbnail.jpg",
"readyToStream": true,
"status": {
"state": "ready"
},
"meta": {
"downloaded-from": "https://storage.googleapis.com/stream-example-bucket/video.mp4",
"name": "My First Stream Video"
},
"created": "2020-10-16T20:20:17.872170843Z",
"size": 9032701,
//...
},
"success": true,
"errors": [],
"messages": []
}

ステップ3: ウェブサイトやアプリで動画を再生

Streamにアップロードされた動画は、ウェブサイトからネイティブアプリまで、あらゆるデバイスとプラットフォームで再生できます。詳細やプラットフォーム間の動画再生の例については、動画を再生を参照してください。

Stream Playerを使用してウェブサイトで動画を再生するには、上記のリクエストから動画のuidとあなたのユニークな顧客コードをコピーし、以下の埋め込みコードの<CODE><VIDEO_UID>を置き換えます:

<iframe
src="https://customer-<CODE>.cloudflarestream.com/<VIDEO_UID>/iframe"
title="Example Stream video"
frameBorder="0"
allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowFullScreen>
</iframe>

上記の埋め込みコードは、Cloudflareダッシュボードでも見つけることができます。

次のステップ

最初のライブストリームを開始

ステップ1: ライブ入力を作成

Cloudflareダッシュボードからライブ入力を作成するか、APIを使用して作成できます。

APIを使用する場合は、以下の例でAPI_TOKENACCOUNT_IDの値をあなたの認証情報に置き換えてください。

リクエスト
curl -X POST \
-H "Authorization: Bearer <API_TOKEN>" \
-D '{"meta": {"name":"test stream"},"recording": { "mode": "automatic" }}' \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/live_inputs
レスポンス
{
"uid": "f256e6ea9341d51eea64c9454659e576",
"rtmps": {
"url": "rtmps://live.cloudflare.com:443/live/",
"streamKey": "MTQ0MTcjM3MjI1NDE3ODIyNTI1MjYyMjE4NTI2ODI1NDcxMzUyMzcf256e6ea9351d51eea64c9454659e576"
},
"created": "2021-09-23T05:05:53.451415Z",
"modified": "2021-09-23T05:05:53.451415Z",
"meta": {
"name": "test stream"
},
"status": null,
"recording": {
"mode": "automatic",
"requireSignedURLs": false,
"allowedOrigins": null
}
}

ステップ2: RTMPS URLとキーをコピーし、ライブストリーミングアプリケーションで使用します。

Open Broadcaster Software (OBS)を使用することをお勧めします。

ステップ3: ウェブサイトやアプリでライブストリームを再生

ライブストリームは、ウェブサイトからネイティブアプリまで、Streamにアップロードされた動画と同じ動画プレーヤーを使用して再生できます。詳細やプラットフォーム間の動画再生の例については、動画を再生を参照してください。

ウェブサイトでStream Playerを使用して、開始したばかりのライブストリームを再生するには、上記のリクエストからライブ入力のuidとあなたのユニークな顧客コードをコピーし、以下の埋め込みコードの<CODE><VIDEO_UID>を置き換えます:

<iframe
src="https://customer-<CODE>.cloudflarestream.com/<VIDEO_UID>/iframe"
title="Example Stream video"
frameBorder="0"
allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowFullScreen>
</iframe>

上記の埋め込みコードは、Cloudflareダッシュボードでも見つけることができます。

次のステップ

アクセシビリティの考慮事項

動画コンテンツをよりアクセシブルにするために、キャプション高品質の音声録音を含めてください。