MediaLive を使用した例 AWS CLI

次のコード例は、 AWS Command Line Interface でを使用してアクションを実行し、一般的なシナリオを実装する方法を示しています MediaLive。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

アクション

次のコード例は、create-channel を使用する方法を示しています。

AWS CLI

チャンネルを作成するには

次のcreate-channel例では、指定するパラメータを含むJSONファイルを渡すことでチャンネルを作成します。

この例のチャンネルは、ビデオ、オーディオ、埋め込みキャプションを含むソースに接続するHLSPULL入力を取り込みます。チャンネルは、Akamai サーバーを送信先として 1 つのHLS出力グループを作成します。出力グループには 2 つの出力が含まれます。1 つは H.265 ビデオとAACオーディオ用、もう 1 VTTつはウェブキャプション用で、英語のみです。

この例のチャンネルJSONのには、HLSPULL入力を使用し、Akamai を宛先とするHLS出力グループを生成するチャンネルに必要な最小パラメータが含まれています。JSON には、次の主要なセクションが含まれています。

InputAttachments。オーディオのソースを 1 つ、字幕のソースを 1 つ指定します。ビデオセレクタを指定しません。つまり、はソースで見つけた最初のビデオを MediaLive 抽出します。にはDestinations、このチャネル内の単一の出力グループの 2 つの IP アドレス (URLs) が含まれます。これらのアドレスにはパスワードが必要です。 EncoderSettingsには、のソースを使用する 1 つのオーディオ出力アセットがチャンネルに含まれていること、 InputAttachmentsAAC形式のオーディオを生成するAudioDescriptionsことを指定します。にはCaptionDescriptions、のソースを使用する 1 つの字幕出力アセットが含まれ InputAttachments、の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-json file://channel-in-hls-out-hls-akamai.json

channel-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 チャンネル用。の最後の部分は一意のチャネル ID ARNです。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-json file://input-hls-pull-news.json

input-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 は入力用です。の最後の部分はAttached Channels一意の入力 ID ARNです。これは、新しく作成された入力では常に空です。この例では空です。DestinationsこれはPUSH入力でのみ使用されるためです。Idこの例ではの ID と同じですARN。この例では空です。MediaConnectFlowsこれはタイプの入力でのみ使用されます MediaConnect。この例ではSecurityGroups空です。このPUSH入力は入力でのみ使用されます。Stateこの入力のは空Tagsです (このパラメータのデフォルト）。

詳細については、「 AWS Elemental MediaLive ユーザーガイド」の「入力の作成」を参照してください。

API 詳細については、AWS CLI 「コマンドリファレンスCreateInput」の「」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

MediaConvert

MediaPackage