Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用したMediaLive の例 AWS CLI
次のコード例は、 AWS Command Line Interface MediaLive を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には、完全なソースコードへのリンクが含まれています。このリンクでは、コンテキストでコードを設定および実行する手順を確認できます。
トピック
アクション
次のコード例は、create-channel を使用する方法を示しています。
- AWS CLI
-
チャンネルを作成するには
次の
create-channel例では、指定したいパラメータを含む JSON ファイルに渡してチャネルを作成します。この例のチャンネルは、ビデオ、オーディオ、埋め込みキャプションを含むソースに接続する PULL HLS 入力を取り込みます。チャネルは、Akamai サーバーを宛先とする 1 つの HLS 出力グループを作成します。出力グループには、H.265 ビデオと AAC オーディオ用の出力と、Web-VTT 字幕用の出力の 2 つの出力があります。1 つは英語のみです。
この例のチャネルの JSON には、HLS PULL入力を使用し、Akamai を宛先とする HLS 出力グループを生成するチャネルに必要な最小パラメータが含まれています。JSON には、次の主要なセクションが含まれています。
InputAttachments。オーディオのソースを 1 つ、字幕のソースを 1 つ指定します。ビデオセレクタを指定しません。つまり、 MediaLive はソースで見つけた最初のビデオを抽出します。これにはDestinations、このチャネル内の単一の出力グループの 2 つの IP アドレス (URLs) が含まれます。これらのアドレスにはパスワードが必要です。EncoderSettingsのサブセクションが含まれています。 はAudioDescriptions、チャンネルに InputAttachments のソースを使用する 1 つのオーディオ出力アセットが含まれていること、および AAC 形式のオーディオを生成することを指定します。 はCaptionDescriptions、チャンネルに InputAttachments のソースを使用する 1 つのキャプション出力アセットが含まれていること、および Web-VTT 形式のキャプションを生成することを指定します。 はVideoDescriptions、チャンネルに 1 つのビデオ出力アセットが含まれていること、および指定された解像度を指定します。OutputGroupsは出力グループを指定します。この例では、 という名前のグループが 1 つありますAkamai。接続は HLS を使用して行われますPUT。出力グループには 2 つの出力が含まれます。1 つの出力は、ビデオアセット ( という名前Video_high) とオーディオアセット ( という名前) 用ですAudio_EN。1 つの出力は、字幕アセット ( という名前) 用ですWebVTT_EN。この例では、一部のパラメータに値が含まれないか、ネストされた空のパラメータが含まれています。例えば、
Video_and_audio出力の OutputSettings には、空のパラメータ M3u8Settings で終わるいくつかのネストされたパラメータが含まれています。このパラメータを含める必要がありますが、1 つ、複数、またはすべての子を省略できます。つまり、子はデフォルト値を取るか null になります。このサンプルチャネルに適用されるが、このファイルで指定されていないすべてのパラメータは、デフォルト値を使用するか、null に設定されるか、 MediaLive によって生成された一意の値を取得します。
aws medialive create-channel \ --cli-input-jsonfile://channel-in-hls-out-hls-akamai.jsonchannel-in-hls-out-hls-akamai.jsonの内容:{ "Name": "News_West", "RoleArn": "arn:aws:iam::111122223333:role/MediaLiveAccessRole", "InputAttachments": [ { "InputAttachmentName": "local_news", "InputId": "1234567", "InputSettings": { "AudioSelectors": [ { "Name": "English-Audio", "SelectorSettings": { "AudioLanguageSelection": { "LanguageCode": "EN" } } } ], "CaptionSelectors": [ { "LanguageCode": "ENE", "Name": "English_embedded" } ] } } ], "Destinations": [ { "Id": "akamai-server-west", "Settings": [ { "PasswordParam": "/medialive/examplecorp1", "Url": "http://203.0.113.55/news/news_west", "Username": "examplecorp" }, { "PasswordParam": "/medialive/examplecorp2", "Url": "http://203.0.113.82/news/news_west", "Username": "examplecorp" } ] } ], "EncoderSettings": { "AudioDescriptions": [ { "AudioSelectorName": "English-Audio", "CodecSettings": { "AacSettings": {} }, "Name": "Audio_EN" } ], "CaptionDescriptions": [ { "CaptionSelectorName": "English_embedded", "DestinationSettings": { "WebvttDestinationSettings": {} }, "Name": "WebVTT_EN" } ], "VideoDescriptions": [ { "Height": 720, "Name": "Video_high", "Width": 1280 } ], "OutputGroups": [ { "Name": "Akamai", "OutputGroupSettings": { "HlsGroupSettings": { "Destination": { "DestinationRefId": "akamai-server-west" }, "HlsCdnSettings": { "HlsBasicPutSettings": {} } } }, "Outputs": [ { "AudioDescriptionNames": [ "Audio_EN" ], "OutputName": "Video_and_audio", "OutputSettings": { "HlsOutputSettings": { "HlsSettings": { "StandardHlsSettings": { "M3u8Settings": {} } }, "NameModifier": "_1" } }, "VideoDescriptionName": "Video_high" }, { "CaptionDescriptionNames": [ "WebVTT_EN" ], "OutputName": "Captions-WebVTT", "OutputSettings": { "HlsOutputSettings": { "HlsSettings": { "StandardHlsSettings": { "M3u8Settings": {} } }, "NameModifier": "_2" } } } ] } ], "TimecodeConfig": { "Source": "EMBEDDED" } } }出力:
出力は、JSON ファイルの内容と以下の値を繰り返します。すべてのパラメータはアルファベット順に並べられます。
ARNチャネル用。ARN の最後の部分は一意のチャネル ID です。EgressEndpointsは PUSH 入力にのみ使用されるため、このサンプルチャネルでは空白です。適用すると、コンテンツがプッシュされる MediaLive のアドレスが表示されます。OutputGroups、Outputs。これらは、含めなかったが、このチャネルに関連するものを含め、出力グループと出力のすべてのパラメータを表示します。パラメータは空 (このチャネル設定でパラメータまたは機能が無効化されていることを示す場合があります) であるか、適用されるデフォルト値を表示する場合があります。LogLevelはデフォルト (DISABLED) に設定されます。Tagsはデフォルト (null)PipelinesRunningCountに設定されます。 はチャネルの現在のステータスStateを表示します。詳細については、AWS Elemental MediaLive ユーザーガイドの「Scratch からのチャネルの作成」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のCreateChannel
」を参照してください。
-
次の例は、create-input を使用する方法を説明しています。
- AWS CLI
-
入力を作成するには
次の
create-input例では、このタイプのHLS PULL入力に適用されるパラメータを含む JSON ファイルに渡して入力を作成します。この入力例の JSON は、取り込みの冗長性をサポートするために、入力への 2 つのソース (アドレス) を指定します。これらのアドレスにはパスワードが必要です。aws medialive create-input \ --cli-input-jsonfile://input-hls-pull-news.jsoninput-hls-pull-news.jsonの内容:{ "Name": "local_news", "RequestId": "cli000059", "Sources": [ { "Url": "https://203.0.113.13/newschannel/anytownusa.m3u8", "Username": "examplecorp", "PasswordParam": "/medialive/examplecorp1" }, { "Url": "https://198.51.100.54/fillervideos/oceanwaves.mp4", "Username": "examplecorp", "PasswordParam": "examplecorp2" } ], "Type": "URL_PULL" }出力:
出力は、JSON ファイルの内容と以下の値を繰り返します。すべてのパラメータはアルファベット順に並べられます。
Arn入力用。ARN の最後の部分は一意の入力 ID です。Attached Channelsこれは新しく作成された入力では常に空です。Destinationsこの例では空です。これは入力では PUSH 入力でのみ使用されます。Idこの例では ARN の ID と同じです。この例では空です。MediaConnectFlowsこれは type MediaConnect の入力でのみ使用されます。この例では空SecurityGroupsです。この入力では PUSH 入力でのみ使用されます。Stateこの入力では空Tagsです (このパラメータのデフォルト）。詳細については、AWS Elemental MediaLive ユーザーガイドの「入力の作成」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のCreateInput
」を参照してください。
-
