

# IVS 低レイテンシーストリーミングを開始する
<a name="getting-started"></a>

このドキュメントでは、最初の Amazon Interactive Video Service (IVS) ライブストリームをセットアップするステップを説明します。

**Topics**
+ [ステップ 1: AWS アカウントの作成](getting-started-create-account.md)
+ [ステップ 2: ルートユーザーと管理ユーザーのセットアップ](getting-started-setup-users.md)
+ [ステップ 3: IAM アクセス許可の設定](getting-started-iam-permissions.md)
+ [ステップ 4: 任意の録画によるチャネルの作成](getting-started-create-channel.md)
+ [ステップ 5: ストリーミングソフトウェアの設定](getting-started-set-up-streaming.md)
+ [ステップ 6: ライブストリームの表示](getting-started-view-stream.md)
+ [ステップ 7: Service-Quota 制限の確認 (オプション)](getting-started-check-service-quota.md)
+ [ステップ 8: 望ましくないコンテンツと視聴者を防ぐ (推奨)](getting-started-prevent-undesired-content.md)

# ステップ 1: AWS アカウントの作成
<a name="getting-started-create-account"></a>

Amazon IVS を使用するには、AWS アカウントが必要です。アカウントをまだお持ちでない場合は、サインアップ時に画面の指示に従って作成してください。AWS アカウントを作成するには:

1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup) を開きます。

1. オンラインの手順に従います。

   サインアップ手順の一環として、通話呼び出しまたはテキストメッセージを受け取り、確認コードを入力することが求められます。また、請求情報を提供する必要がありますが、ベーシックなサービス層は無料です。サインアップした AWS サービスの料金は、そのサービスを使用しない限り発生することはありません。

1. アカウントの作成後に、**サインイン URL** および**ユーザー名**が記載された電子メールが送信され、(AWS アカウント管理者から) パスワードが記載された別の電子メールが送信されます。初回サインイン時にパスワードを変更する必要があります。

既存の AWS アカウントを使用する場合は、Amazon IVS をサポートしている AWS リージョンを使用していることを確認してください。

1. [Amazon IVS コンソール](https://console.aws.amazon.com/ivs)に移動します。(「グローバルソリューション、地域別コンテンツ」と表示されている) 通常の IVS コンソールページが表示されれば、問題ありません。「[ステップ 2: ルートユーザーと管理ユーザーのセットアップ](getting-started-setup-users.md)」に進んでください。AWS の「サポート対象外リージョン」ページにリダイレクトされた場合は、新しいリージョンを選択する必要があります。

1. 適切なタブ (IVS の場合は **[ライブストリーミング]**、IVS チャットの場合は **[ストリーミングチャット]** ) を選択し、リストからいずれかのリージョンを選択します。後で必要になるので、どのリージョンを選択したのかをメモしておきます。

[https://aws.amazon.com/](https://aws.amazon.com/) の **[My Account]** (アカウント) をクリックして、いつでもアカウントの AWS のアクティビティを表示し、アカウントを管理することができます。

# ステップ 2: ルートユーザーと管理ユーザーのセットアップ
<a name="getting-started-setup-users"></a>

AWS アカウントにサインアップすると、AWS アカウントのルートユーザーが作成されます。ルートユーザーには、アカウントのすべての AWS サービスとリソースへのアクセス権があります。セキュリティのベストプラクティスとして、[管理ユーザーに管理アクセスを割り当て](https://docs.aws.amazon.com/singlesignon/latest/userguide/useraccess.html)、[ルートユーザーアクセスが必要なタスク](https://docs.aws.amazon.com/IAM/latest/UserGuide/root-user-tasks.html)を実行する場合にのみ、ルートユーザーを使用してください。

## AWS アカウントのルートユーザーを保護する
<a name="setup-users-secure-root-user"></a>

1. IAM Identity Center に管理ユーザーとしてサインインするには、IAM Identity Center ユーザーの作成時に E メールアドレスに送信されたサインイン URL を使用します。IAM Identity Center ユーザーを使用してサインインする方法については、「*AWS サインインユーザーガイド*」の「[AWS アクセスポータルにサインインする](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html)」を参照してください。

   ルートユーザーを使用してログインする方法については、「*AWS サインインユーザーガイド*」の「[Signing in as the root user](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)」を参照してください。

1. ルートユーザーの多要素認証 (MFA) を有効にします。

   手順については、「*IAM ユーザーガイド*」の「[Enable a virtual MFA device for your AWS account root user (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html#enable-virt-mfa-for-root)」を参照してください。

## 管理ユーザーを作成する
<a name="setup-users-create-admin-user"></a>

日常的なタスクにルートユーザーを使用しないように、管理ユーザーを作成します。
+ 日常的な管理タスクでは、AWS IAM アイデンティティセンター (AWS Single Sign-On の後継) の管理ユーザーに、管理アクセスを割り当てます。手順については、「*AWS IAM アイデンティティセンター (AWS Single Sign-On の後継) ユーザーガイド*」の「[はじめに](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)」を参照してください。
+ IAM Identity Center に管理ユーザーとしてサインインするには、IAM Identity Center ユーザーの作成時に E メールアドレスに送信されたサインイン URL を使用します。IAM Identity Center ユーザーを使用してサインインする方法については、「*AWS サインインユーザーガイド*」の「[AWS アクセスポータルにサインインする](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html)」を参照してください。

# ステップ 3: IAM アクセス許可の設定
<a name="getting-started-iam-permissions"></a>

次に、基本的なアクセス許可のセット (Amazon IVS チャネルの作成、ストリーミング情報の取得、S3 への自動記録) が可能になる AWS Identity and Access Management (IAM) ポリシーを作成し、ユーザーにこのポリシーを割り当てます。[新しいユーザー](#iam-permissions-new-user)の作成時にアクセス許可を追加するか、あるいは[既存のユーザー](#iam-permissions-existing-user)にアクセス許可を追加することができます。両方の手順を以下に示します。

詳細 (IAM ユーザーとポリシーについて、ポリシーをユーザーにアタッチする方法、Amazon IVS を使用してユーザーのアクションを制限する方法など) については、以下を参照してください。
+ *IAM ユーザーガイド*の [IAM ユーザーの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#Using_CreateUser_console)
+ IAMに関する [Amazon IVS のセキュリティ](security.md) と「IVSのマネージドポリシー」に関する情報。
+ S3 への録画機能の場合: *Amazon IVS ユーザーガイド*の「[サービスにリンクされたロールの使用](security-service-linked-roles.md)」および「[Amazon S3 への自動録画](record-to-s3.md)」

Amazon IVS 用の既存の AWS マネージドポリシーを使用するか、ユーザー、グループ、またはロールのセットに付与する権限をカスタマイズする新しいポリシーを作成できます。両方のアプローチを以下にて説明します。

## IVS のアクセス許可には既存のポリシーを使用してください。
<a name="iam-permissions-existing-policy"></a>

ほとんどの場合、Amazon IVS には AWS マネージドポリシーを使用することになります。これらについては、「*IVS のセキュリティ*」の「[IVS 用マネージドポリシー](security-iam-awsmanpol.md)」セクションで詳しく説明されています。
+ `IVSReadOnlyAccess` AWS マネージドポリシーを使用し、アプリケーションデベロッパーにすべての IVS Get および List API オペレーション (低レイテンシーおよびリアルタイムストリーミングの両方) へのアクセスを許可します。
+ `IVSFullAccess` AWS マネージドポリシーを使用して、アプリケーションデベロッパーにすべての IVS API オペレーション (低レイテンシーおよびリアルタイムストリーミングの両方) へのアクセスを許可します。

## オプション: Amazon IVS アクセス許可の新しいポリシーを作成する
<a name="iam-permissions-new-policy"></a>

以下の手順に従ってください。

1. AWS マネジメントコンソールにサインインして、IAM コンソールを開きます。[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)

1. ナビゲーションペインで、**[ポリシー]**、**[ポリシーの作成]** の順に選択します。**[アクセス許可の指定]** ウィンドウが開きます。

1. **[アクセス許可の指定]** ウィンドウで、**[JSON]** タブをクリックし、次の IVS ポリシーをコピーして **[ポリシーエディタ]** テキスト領域に貼り付けます。(このポリシーにはすべての Amazon IVS アクションが含まれるわけではありません。必要に応じてオペレーションのアクセス許可を追加/削除 (許可/拒否) できます。IVS オペレーションの詳細については「[IVS 低レイテンシーストリーミング API リファレンス](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/Welcome.html)」を参照してください)

------
#### [ JSON ]

****  

   ```
   {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
         {
            "Effect": "Allow",
            "Action": [
               "ivs:CreateChannel",
               "ivs:CreateRecordingConfiguration",
               "ivs:GetChannel",
               "ivs:GetRecordingConfiguration",
               "ivs:GetStream",
               "ivs:GetStreamKey",
               "ivs:GetStreamSession",
               "ivs:ListChannels",
               "ivs:ListRecordingConfigurations",
               "ivs:ListStreamKeys",
               "ivs:ListStreams",
               "ivs:ListStreamSessions"
             ],
             "Resource": "*"
         },
         {
            "Effect": "Allow",
            "Action": [
               "cloudwatch:DescribeAlarms",
               "cloudwatch:GetMetricData",
               "s3:CreateBucket",
               "s3:GetBucketLocation",
               "s3:ListAllMyBuckets",
               "servicequotas:ListAWSDefaultServiceQuotas",
               "servicequotas:ListRequestedServiceQuotaChangeHistoryByQuota",
               "servicequotas:ListServiceQuotas",
               "servicequotas:ListServices",
               "servicequotas:ListTagsForResource"
            ],
            "Resource": "*"
         },
         {
            "Effect": "Allow",
            "Action": [
               "iam:AttachRolePolicy",
               "iam:CreateServiceLinkedRole",
               "iam:PutRolePolicy"
            ],
            "Resource": 
   "arn:aws:iam::*:role/aws-service-role/ivs.amazonaws.com/AWSServiceRoleForIVSRecordToS3*"
         }
      ]
   }
   ```

------

1. **[アクセス許可の指定]** ウィンドウを開いたまま、**[次へ]** を選択します (ウィンドウの一番下までスクロールすると表示されます)。**[レビューと作成]** ウィンドウが開きます。

1. **[レビューと作成]** ウィンドウで、ポリシーに**ポリシー名**を入力します。オプションで**説明**を追加します。ユーザーを作成する時に必要になるので、ポリシーの名前を書きとめておきます (下記を参照してください)。ページの最下部で、**[Create policy]** (ポリシーの作成) を選択します。

1. IAM コンソールウィンドウが表示され、新しいポリシーが作成されたことを確認するバナーが表示されます。

## 新しいユーザーを作成し、アクセス許可を付与する
<a name="iam-permissions-new-user"></a>

### IAM ユーザーアクセスキー
<a name="iam-permissions-new-user-access-keys"></a>

IAM アクセスキーは、アクセスキー ID とシークレットアクセスキーで構成されます。これは AWS へのプログラムによるリクエストの署名に使用されます。アクセスキーがない場合は、AWS マネジメントコンソールから作成できます。ベストプラクティスとして、ルートユーザーのアクセスキーは作成しないでください。

*シークレットアクセスキーを表示またはダウンロードできるのは、アクセスキーを作成するときのみです。後で回復することはできません。*ただ、アクセスキーはいつでも新しく作成できます。必要な IAM アクションを実行するためのアクセス許可が必要です。

アクセスキーは、常に安全に保管してください。(例え Amazon からの問い合わせであっても) 第三者と共有しないでください。詳細については、「*IAM ユーザーガイド*」の「[IAM ユーザーのアクセスキーの管理](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)」を参照してください。

### 手順
<a name="iam-permissions-new-user-procedure"></a>

以下の手順に従ってください。

1. ナビゲーションペインで **[ユーザー]**、**[ユーザーの作成]** の順に選択します。**[ユーザーの詳細を指定]** ウィンドウが開きます。

1. **[ユーザーの詳細を指定]** ウィンドウで次の手順を実行します。

   1. **[ユーザーの詳細]** で、作成する新しい**ユーザーの名前**を入力します。

   1. **[AWS マネジメントコンソールへのユーザーアクセスを提供]** を選択します。

   1. プロンプトが表示されたら、**[IAM ユーザーを作成します]** を選択します。

   1. **[コンソールパスワード]** で、**[自動生成パスワード]** を選択します。

   1. **[ユーザーは次回サインイン時に新しいパスワードを作成する必要があります]** を選択します。

   1. [**次へ**] を選択します。**[アクセス許可の設定]** ウィンドウが開きます。

1. **[アクセス許可の設定]** で、**[ポリシーを直接アタッチする]** を選択します。**[アクセス許可ポリシー]** ウィンドウが開きます。

1. 検索ボックスに、IVS ポリシー名 (AWS マネージドポリシーまたは以前に作成したカスタムポリシー) を入力します。見つかったら、チェックボックスをオンにして、ポリシーを選択します。

1. ページの最下部で、**[次へ]** を選択します。**[レビューと作成]** ウィンドウが開きます。

1. **[レビューと作成]** ウィンドウで、ユーザーのすべての詳細が正しいことを確認してから、ウィンドウ最下部にある **[ユーザーの作成]** を選択します。

1. **[パスワードの取得]** ウィンドウが開き、**コンソールサインインの詳細**が表示されます。*後で参照できるように、この情報を保存しておきます*。完了したら、**[ユーザーリストに戻る]** を選択します。

## 既存のユーザーへのアクセス許可を追加する
<a name="iam-permissions-existing-user"></a>

以下の手順に従ってください。

1. AWS マネジメントコンソールにサインインして、IAM コンソールを開きます。[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)

1. ナビゲーションペインで、 [**Users (ユーザー) **] を選択し、更新する既存のユーザー名を選択します。(名前をクリックして選択します。選択ボックスはチェックしないでください。)

1. **概要**ページの[**アクセス許可**] タブで、[**アクセス許可の追加**] を選択します。**[アクセス許可の追加**] ウィンドウが開きます。

1. **[既存のポリシーを直接アタッチ]** を選択します。**[アクセス許可ポリシー]** ウィンドウが開きます。

1. 検索ボックスに、IVS ポリシー名 (AWS マネージドポリシーまたは以前に作成したカスタムポリシー) を入力します。ポリシーが見つかったら、チェックボックスをオンにして、ポリシーを選択します。

1. ページの最下部で、**[次へ]** を選択します。**[レビュー]** ウィンドウが開きます。

1. **[レビュー]** ウィンドウの下部にある **[アクセス許可の追加]** を選択します。

1. **[Summary]** (概要) ページで、IVS ポリシーが追加されたことを確認します。

# ステップ 4: 任意の録画によるチャネルの作成
<a name="getting-started-create-channel"></a>

Amazon IVS チャネルには、ライブストリームに関連する設定情報が保存されます。まず、チャネルを作成し、チャネルのストリームキーを使用してチャネルに動画を投稿し、ライブストリームを開始します。

チャネル作成の一環として、以下の項目が割り当てられます。
+ *取り込みサーバー*は、ストリームを受信する特定の Amazon IVS コンポーネントと、取り込みプロトコル (RTMPS または RTMP) を識別します。
+ チャネルを作成し、ストリーミングを許可する際に、Amazon IVS は*ストリームキー*を割り当てます。***すべてのユーザーがチャネルにストリーミングできるため、ストリームキーは機密情報として扱ってください***。
+ *再生 URL*は、特定のチャネルの再生を開始するエンドポイントを識別します。このエンドポイントはグローバルに使用できます。このエンドポイントは、Amazon IVS グローバルコンテンツ配信ネットワークから、視聴者が動画をストリーミングするのに最適な場所を自動的に選択します。(Amazon IVS は再生用のカスタムドメインをサポートしていないことに注意してください。*自分のドメインで再生 URL をプロキシしないでください。ドメインが機能せず、問題が発生します。*)

 Amazon IVS コンソールまたは AWS CLI を介して、録画の有無にかかわらずチャネルを作成できます。チャネルの作成と録画については、以下で説明します。チャネルの作成と録画については、以下で説明します。

# Amazon S3 への自動録画
<a name="create-channel-auto-r2s3"></a>

チャネルの録画を有効にするオプションもあります。S3 への自動録画機能が有効になっている場合、チャネル上のすべてのストリームが録画され、所有する Amazon S3 ストレージバケットに保存されます。その後、この録画はオンデマンド再生が可能です。

このセットアップは拡張オプションです。デフォルトでは、チャネルの作成時に録画は無効になっています。

録画用のチャネルを設定する前に、*録画設定*を作成する必要があります。これは、チャネルの録画されたストリームが保存される Amazon S3 の場所を指定するリソースです。コンソールまたは CLI を使用して、録画設定を作成および管理することができます。両方の手順を以下に示します。録画設定を作成した後、チャネルの作成時（以下で説明）または後で既存のチャネルを更新することで、録画設定をチャネルに関連付けます。（API では、「[CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html)」および「[UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html)」を参照してください。） 複数のチャネルを同じ録画設定に関連付けることができます。どのチャネルにも関連付けられていない録画設定は削除できます。

次の制約に注意が必要です。
+ S3 バケットを所有している必要があります。つまり、録画するチャネルを設定するアカウントは、録画を保存する S3 バケットを所有している必要があります。
+ チャネル、録画設定、および S3 の場所は、同じ AWS リージョン内にある必要があります。他のリージョンでチャネルを作成して録画する場合は、それらのリージョンで録画設定と S3 バケットも設定する必要があります。

S3 バケットに録画するには、AWS 認証情報を使用した認可が必要です。IVS に必要なアクセス権を付与するには、AWS IAM [サービスにリンクされたロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)（SLR）が録画設定を作成するときに自動的に作成されます。SLR は、特定のバケットだけに対して IVS 書き込み許可を与えるように制限されます。

ストリーミングロケーションと AWS 間、または AWS 内のネットワークの問題により、ストリームの録画中にデータが失われる可能性があることに注意してください。このような場合、Amazon IVS は録画よりもライブストリームを優先します。冗長性のために、ストリーミングツールでローカルに録画してください。

録画したファイルのポスト処理や VOD 再生の設定方法など、詳しい情報は「[Amazon S3 への IVS 自動録画 \$1 Low-Latency Streaming](record-to-s3.md)」を参照してください。

## 録画を無効にする方法
<a name="getting-started-disable-recording"></a>

既存のチャネルで Amazon S3 録画を無効にするには
+ コンソール — 該当するチャネルの詳細ページにある [**Record and store (記録と保存)**] ストリームセクションで、[**Disabled (無効)**] を選択し、次に [**Save Channel (チャネルの保存)**] を選択します。これにより、録画設定とチャネルとの関連付けが解除され、そのチャネル上のストリームは録画されなくなります。
+ CLI — `update-channel`コマンドを実行し、録画設定の ARN を空の文字列として渡します。

  ```
  aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn ""
  ```

  これにより、録画が無効であることを示す、`recordingConfigurationArn`の空の文字列を持つチャネルオブジェクトが返されます。

# IVS チャネルを作成するためのコンソールでの手順
<a name="create-channel-console"></a>

これらのステップは、初期チャネルのセットアップ、Amazon S3 への自動録画のセットアップ (オプション)、最終的なチャネル作成の 3 つのフェーズに分かれています。

## 初期チャネルの設定
<a name="create-channel-console-setup"></a>

1. [Amazon IVS コンソール](https://console.aws.amazon.com/ivs)を開きます。

   ([AWS マネジメントコンソール](https://console.aws.amazon.com/)から Amazon IVS コンソールにアクセスすることもできます)。

1. ナビゲーションバーから、[**Select a Region (リージョンの選択)**] ドロップダウンをクリックして、リージョンを選択します。新しいチャネルがこのリージョンに作成されます。

1. [**Get started (開始する)**] ボックス (右上) で、[**Create Channel (チャネルの作成)**] を選択します。

1. [**Channel configuration (チャネル設定)**] で、[**Default configuration (デフォルト設定)**] を許可します。オプションで、[**Channel name (チャネル名)**] を指定します。チャネル名は一意ではありませんが、チャネル ARN (Amazon リソースネーム) 以外のチャネルを区別するのに役立ちます。

   注: **カスタム設定**を使用して、チャネルタイプや (RTMPS の代わりに) RTMP インジェストなど、デフォルト以外の特定の値を指定できます。カスタム仕様はここには記載されていません。  
![\[IVS コンソール を使用してチャネルを作成する: [Create Channel (チャネルの作成)] ウィンドウでチャネル設定を指定します。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/images/Accept_Default_Configuration.png)

1. Amazon S3 に自動録画する場合は、以下の [Amazon S3 への自動録画の設定 (オプション)](#getting-started-create-channel-console-record-s3) に進みます。それ以外の場合は、スキップして直接[最終チャネルの作成](#getting-started-create-channel-console-final-creation)に進んでください。

## Amazon S3 への自動録画の設定 (オプション)
<a name="getting-started-create-channel-console-record-s3"></a>

次のステップに従って、新しいチャネルの作成中に録画を有効にします。

1. **[チャネルの作成]** ページの **[ストリームの記録と保存]** で、**[自動録画の有効化]** を選択します。追加のフィールドが表示され、既存の [**Recording configuration (録画設定)**] を選択できます。新規の録画設定を作成することもできます。  
![\[IVS コンソールを使用してチャネルを作成する: [Auto-record to Amazon S3 (Amazon S3 への自動録画)] を選択します。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/images/Select_Auto_Record.png)

1. [**Create recording configuration (録画設定の作成）**] を選択します。新しいウィンドウが開きます。オプションを使用して、Amazon S3 バケットを作成し、新しい録画設定にアタッチします。  
![\[IVS コンソールを使用してチャネルを作成する: 録画設定の保存オプションを指定します。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/images/Click_Create_Recording_Config.png)

1. 次のフィールドに入力します。

   1. 必要に応じて**録画設定名**を入力します。

   1. **[チャネルの設定]** で、**[デフォルト設定]** を有効にします。注意: **カスタム構成**は、記録されたレンディションや断片化されたストリームのマージなど、デフォルト以外の特定の値を指定する際に使用できます。カスタム仕様はここには記載されていません。

   1. [**バケット名**] を入力します。

1. **[Create]** (作成) を選択して、一意の ARN を持つ新規の録画設定リソースを作成します。通常、録画設定の作成は数秒ですが、最大で 20 秒かかることがあります。録画設定が作成されると、[**Create channel (チャネルの作成)**] ウィンドウに戻ります。**[ストリーミングの録画と保存]** エリアには、新しい **録画設定** が表示され、**[状態]** は**アクティブ**で、作成した S3 バケット (**ストレージ**) が表示されます。  
![\[IVS コンソール を使用してチャネルを作成する: 新しい録画設定が作成されました。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/images/Create_Recording_Config.png)

## 最終チャネルの作成
<a name="getting-started-create-channel-console-final-creation"></a>

1. **[チャネルの作成]** ウィンドウの下部で、**[チャネルの作成]** を選択し、一意の ARN を持つ新しいチャネルを作成します。チャネルの詳細を表示するには、**[詳細]** を展開します。(注: 録画を有効にしなかった場合は、**S3 への自動録画**は、**無効**に設定されます。画面には、**録画設定**セクションが表示されません)。  
![\[IVS コンソール を使用してチャネルを作成する: [Channel Details] (チャネルの詳細) ウィンドウでチャネルストリーム、再生・録画の設定、ストリームセッションを表示します。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/images/Final_Channel_Creation.png)

1. **重要**:
   + [**Stream configuration (ストリームの設定)**] エリアで、**取り込みサーバー**および**ストリームキー**を書き留めます。次のステップでこれらを使用し、ストリーミングを設定します。
   + [**Playback configuration (再生設定)**] エリアで、**再生 URL** を書き留めます。後でそれを使用し、ストリームを再生します。

**注**: SRT 値 (エンドポイントとパスフレーズ) を表示するには、**[ストリーム設定]** の **[その他の取り込みオプション]** を展開します。

# IVS チャネルを作成するための CLI の手順
<a name="create-channel-cli"></a>

AWS CLI を使用してチャネルを作成することは詳細オプションであり、最初に CLI をダウンロードしてマシンに設定する必要があります。詳細については、[AWS コマンドラインインターフェイスのユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)を参照してください。

チャネル作成時に録画を有効／無効にするかどうかに応じて、次の 2 つの手順のいずれかに従います。

## 録画せずにチャネルを作成する
<a name="getting-started-create-channel-cli-no-recording"></a>

1. `create-channel`コマンドを実行し、オプション名を渡します:

   ```
   aws ivs create-channel --name test-channel
   ```

1. これにより、新しいチャネルが返されます。

   ```
   {
      "channel": {
         "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
         "authorized": false,
         "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
         "insecureIngest": false,
         "latencyMode": "LOW",
         "name": "channel-live",
         "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/abcdABCDefgh",
         "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
         "recordingConfigurationArn": "none",
         "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
         },
         "tags": {},
         "type": "STANDARD"
      },
      "streamKey": {
         "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
         "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
         "tags": {},
         "value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
      }
   }
   ```

1. **重要**: `ingestEndpoint`、`streamKey value`、および `playbackUrl` の点に注意してください。これらを使用して、ストリーミングと再生を設定します。

## 録画付きチャネルの作成
<a name="getting-started-create-channel-cli-recording"></a>

**前提条件** この手順を開始する前に Amazon S3 バケットを作成し、その ARN を書き留めます。[Amazon S3 の開始方法](https://docs.aws.amazon.com//AmazonS3/latest/userguide/GetStartedWithS3.html)を参照してください。S3 バケットは、録画設定を作成する同じリージョンに作成する必要があります。以下のステップ 1 の既知の問題を参照してください。

次に、以下のステップに従ってチャネルを作成します。

1. `create-recording-configuration`コマンドを実行して、既存の Amazon S3 バケットの ARN を渡します。

   ```
   aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket}
   ```

   オプションで、`thumbnail-configuration` パラメータを渡してサムネイルの記録モードとサムネイル間隔を手動で設定します。

   ```
   aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=s3_bucket_name} --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=60
   ```

   必要に応じて `recording-reconnect-window-seconds` パラメータを渡して、断片化されたストリームの結合の機能を有効にします。

   ```
   aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket} --recording-reconnect-window-seconds 60
   ```

   **既知の問題:** us-east-1 リージョンでは、AWS CLI を使用して録画設定を作成すると、S3 バケットが別のリージョンにある場合でも成功が返されます。この場合、録画設定の`state`は、(`ACTIVE`の代わりに) `CREATE_FAILED`となります。(他のリージョンでは、バケットが別のリージョンにある場合、CLI は正しく失敗を返します)。

   **回避方法:** S3 バケットが録画設定と同じリージョンにあることを確認してください。S3 バケットとして別のリージョンに録画設定を作成する場合は、その録画設定を削除し、正しいリージョンから S3 バケットで新しい録画設定を作成します。

1. これにより、一意の ARN を持つ新しい録画設定が返されます。録画設定の状態が`CREATING`の場合は、作成中であることを示しています。

   ```
   {
      "recordingConfiguration": {
         "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
         "name": "configuration-1",
         "destinationConfiguration": {
            "s3": {
               "bucketName": "s3_bucket_name"
            }
         },
         "recordingReconnectWindowSeconds": 60,
         "state": "CREATING",
         "tags": {},
         "thumbnailConfiguration": {
            "recordingMode": "INTERVAL",
            "targetIntervalSeconds": 60
         }
      }
   }
   ```

1. 通常、録画設定の作成は数秒ですが、最大で 20 秒かかることがあります。録画設定が作成されたことを確認するには、`get-recording-configuration`コマンドを実行します。

   ```
   aws ivs get-recording-configuration --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
   ```

1. これにより、録画設定が作成されたことを示すレスポンスが返されます (`state`は`ACTIVE`)。

   ```
   {
      "recordingConfiguration": {
         "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
         "name": "configuration-1",
         "destinationConfiguration": {
            "s3": {
               "bucketName": "s3_bucket_name"
            }
         },
         "recordingReconnectWindowSeconds": 60,
         "state": "ACTIVE",
         "tags": {},
         "thumbnailConfiguration": {
            "recordingMode": "INTERVAL",
            "targetIntervalSeconds": 60
         }
      }
   }
   ```

1. チャネルを作成し、そのチャネルでの録画を有効にするには、`create-channel`コマンドを実行し、録画設定の ARN を渡します。

   ```
   aws ivs create-channel --name channel-live --recording-configuration-arn  "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
   ```

   または、既存のチャネルでの録画を有効にするために、`update-channel`コマンドを実行し、録画設定の ARN を渡します。

   ```
   aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
   ```

1. これにより、録画が有効であることを示す、`recordingConfigurationArn` の「none」以外の値を持つチャネルオブジェクトが返されます。(以下の応答は`create-channel`からのものです。`update-channel`レスポンスには`streamKey`オブジェクトは含まれません)。

   ```
   {
      "channel": {
         "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
         "authorized": false,
         "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
         "insecureIngest": false,
         "latencyMode": "LOW",
         "name": "channel-live",
         "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
         "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
         "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
         },
         "tags": {},
         "type": "STANDARD"
      },
      "streamKey": {
         "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
         "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
         "tags": {},
         "value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
      }
   }
   ```

1. **重要**: `ingestEndpoint`、`streamKey value`、および `playbackUrl` の点に注意してください。これらを使用して、ストリーミングと再生を設定します。

# ステップ 5: ストリーミングソフトウェアの設定
<a name="getting-started-set-up-streaming"></a>

以下の方法で Amazon IVS にストリーミング (低レイテンシー) できます。
+ RTMPS をサポートする、ネイティブの [IVS Broadcast SDK](#broadcast-sdk)。特に本稼働シナリオでは、こちらをお勧めします。
+ [Amazon IVS コンソール](#ivs-console) – ストリームのテストに適しています。
+ その他のストリーミングソフトウェアおよびハードウェアエンコーダー — RTMP、RTMPS、または SRT プロトコルをサポートする任意のストリーミングエンコーダーを使用できます。Open Broadcast Software (OBS) と FFmpeg を RTMPS と SRT で使用するいくつかの例を以下に示します。RTMPS は、暗号化された TLS ストリームを使用して、高セキュリティを実現します。

キーエンコーダの設定は、キーフレーム間隔（2 秒）と解像度/ビットレート/フレームレート（相互に関連する）です。エンコーダ設定の詳細については、次を参照してください。
+ *Amazon IVS ユーザーガイド*の「[ストリーミング設定](streaming-config.md)」を参照してください。
+ ブログ記事: [Setting Up for Streaming with Amazon Interactive Video Service](https://aws.amazon.com/blogs/media/setting-up-for-streaming-with-amazon-ivs/)

**注意**: 
+ Amazon IVS ストリームの最大継続時間は 48 時間です。その後、ストリームは終了し、ストリーミングセッションは切断されます。(自動または手動で) 正常に再接続すると、新しいストリームが開始されます。
+ エンコーダーが (一時的なネットワークの問題などの原因で) データの送信を停止した場合、Amazon IVS は 30 秒間待機します。この間にブロードキャスターのデータが受信されない場合、Amazon IVS の接続が解除されます。

## Amazon IVS Broadcast SDK によるストリーミング
<a name="broadcast-sdk"></a>

iOS または Android アプリケーションからブロードキャストするには、Amazon IVS Broadcast SDK を使用できます。ブロードキャスト SDK は Amazon IVS アーキテクチャを活用し、Amazon IVS と共に継続的な改善と新しい機能を見ていきます。ネイティブのモバイルブロードキャスト SDK として、アプリケーションおよびユーザーがアプリケーションにアクセスするデバイスに対するパフォーマンスへの影響を最小限に抑えるように設計されています。


| 以下からブロードキャストするには..。 | 以下を使用できます..。 | 注意事項 | 
| --- | --- | --- | 
| Android または iOS アプリケーション | Amazon IVS Android または iOS Broadcast SDK | ネイティブのモバイルブロードキャスト SDK として、アプリケーションおよびユーザーがアプリケーションにアクセスするデバイスに対するパフォーマンスへの影響を最小限に抑えるように設計されています。 | 
| ウェブ環境 | Amazon IVS Web Broadcast SDK | Web Broadcast SDK として、Amazon IVS Web Broadcast SDK を使用すると、WebRTC を使用してウェブ環境からブロードキャストできます。クロスブラウザとクロスプラットフォームをサポートします。 | 

詳細については、「[IVS Broadcast SDK \$1 Low-Latency Streaming](broadcast.md)」を参照してください。

## Amazon IVS コンソールを使用したストリーミング
<a name="ivs-console"></a>

1. [Amazon IVS コンソール](https://console.aws.amazon.com/ivs)を開きます。

   ([AWS マネジメントコンソール](https://console.aws.amazon.com/)から Amazon IVS コンソールにアクセスすることもできます。)

1. ナビゲーションペインで、[**チャネル**] を選択します。(ナビゲーションペインが折りたたまれている場合は、ハンバーガーアイコンを選択して展開します)

1. ブロードキャスト先のチャネルを選択し、その詳細ページに移動します。

1. **[ブロードキャスト]** タブを選択します。(これらのタブは、**[一般的な設定]** セクションの下にあります)

1. カメラとマイクへの IVS コンソールアクセスを許可するように求められます。これらの権限を**許可**してください。

1. **[ブロードキャスト]** タブの下部にあるドロップダウンボックスを使用して、マイクとカメラの入力デバイスを選択します。

1. ストリーミングを開始するには、**[ブロードキャストを開始]** を選択します。

1. ライブストリームを視聴するには、**[再生]** タブに移動します。

   **注**: ストリームを開始した後、[再生] タブで視聴できるようになるまでに、短い遅延 (通常は 30 秒未満) が発生することが予想されます。

この機能を使うと、複数のチャネルに同時にブロードキャストできます。

**注**: コンソールからのストリーミングはリソースを消費するため、ライブ動画入力コストが発生します。詳細については、「IVS 料金表」の「[ライブ動画入力にかかるコスト](https://aws.amazon.com/ivs/pricing/#Low-Latency_Streaming)」を参照してください。

## RTMPS を使用した OBS Studio によるストリーミング
<a name="obs-rtmps"></a>

([OBS Studio](https://obsproject.com/)) は、録画およびライブストリーミングに適した無料のオープンソースソフトウェアです。OBS Studio は、リアルタイムのソースとデバイスのキャプチャ、シーンの構成、エンコーディング、記録、ストリーミングを提供します。

OBS Studio v30.2 以降をすぐに起動して実行するには、次の手順に従ってください。

1. ソフトウェアをダウンロードしてインストールします: [https://obsproject.com/download](https://obsproject.com/download)。

1. OBS Studio を初めてロードするときに表示される、OBS Studio の**自動設定ウィザード**を実行します。ステップに従い、デフォルト値を受け入れます。

1. **[ストリーム情報]** で、**[サービス]** ドロップダウンから **[Amazon IVS]** を選択し、**ストリームキー**を入力します。

   Amazon IVS コンソールでチャネルを作成した場合、OBS に入力する**ストリームキー**はコンソールの**ストリームキー**になります (`sk_us-west-2_abcd1234efgh5678ijkl`)。

   AWS CLI でチャネルを作成した場合、OBS に入力する**ストリームキー**は CLI レスポンスの **streamKey 値** になります (`sk_us-west-2_abcd1234efgh5678ijkl`)。

   IVS チャネルがマルチトラックビデオ入力用に設定されている場合は、**[マルチトラック動画を有効にする]** を選択します。オプションで、**最大動画トラック数**と**最大ストリーミング帯域幅**の設定を行います。これは、自動設定されたストリーム設定を制限するために使用される設定です。

1. **動画出力の解像度**と**ビットレート**については、「*Amazon IVS ストリーミング設定*」の「[チャネルタイプ](streaming-config.md#streaming-config-settings-channel-types)」を参照してください。OBS ウィザードで選択したいずれかの値が Amazon IVS で許可されている値を超える場合は、Amazon IVS への接続に失敗しないように手動で値を調整する必要があります。ウィザードの完了後、次の操作を行います。

   1. 動画の解像度を調整するには、**[Settings > Video > Output (Scaled) Resolution]** (設定 > 動画 > 出力 (スケーリング) 解像度) を使用します。

   1. 動画のビットレートを調整するには、**[Settings > Output > Streaming > Video Bitrate]** (設定 > 出力 > ストリーミング > 動画ビットレート) を使用します。

      **注:** 以前に **[マルチトラックビデオを有効にする]** をオンにしていた場合、これはライブストリームには影響しません。

1. ストリームの安定性を高め、ビューア再生時のバッファリングを回避するために、2 秒間の**キーフレーム間隔**をお勧めします。ウィザードが完了したら、**[設定] > [出力] > [出力モード]** に進み、**[詳細]** を選択し、**[ストリーミング]** タブで **[キーフレーム間隔]** が 2 になっていることを確認します。

   **注:** 以前に **[マルチトラックビデオを有効にする]** をオンにしていた場合、キーフレーム間隔は自動的に設定されます。

1. OBS Studio のメインウィンドウで、[**Start Streaming (ストリーミングの開始)**] を選択します。

OBS Studio によるストリーミングの詳細については、[OBS Studio Quickstart](https://obsproject.com/wiki/OBS-Studio-Quickstart)を参照してください。

OBS の設定は後で手動で変更できます。

1. [**Settings (設定) > Stream (ストリーム)**] を選択します。

1. ドロップダウンから **[Amazon IVS]** を選択します。

1. **ストリームキー**を貼り付けます。

ウィザードはいつでも再実行できます。[**Tools (ツール) > Auto-Configuration Wizard (自動構成ウィザード)**] を選択してください。

オプションで、ライブストリームを**Settings (設定) > General (全般)**にローカルに保存することで、後で使用できます。前述のように、ブロードキャストと AWS 間または AWS 内のネットワークの問題により、ストリームの録画中にデータが失われる可能性があります。このような場合、Amazon IVS は録画よりもライブストリームを優先します。ストリーミングツールでローカルに録画することで、冗長性が得られます。

OBS Studio のアップデートを定期的にチェックして、最新バージョンに更新することをお勧めします。（例えば、「Failed to connect to server (サーバーへの接続に失敗しました) 」というエラーが表示された場合は、RTMPS をサポートしていない古いバージョンの OBS Studio を使用している可能性があります。）

## SRT を使用した OBS Studio によるストリーミング
<a name="obs-srt"></a>

Secure Reliable Transport プロトコルをすぐに起動して実行するには、次の手順に従います。

1. ソフトウェアをダウンロードしてインストールします: [https://obsproject.com/download](https://obsproject.com/download)。

1. OBS Studio を初めてロードするときに表示される、OBS Studio の**自動設定ウィザード**を実行します。ステップに従い、デフォルト値を受け入れます。

1. **[ストリーム情報]** で、**[サービス]** ドロップダウンから **[カスタム...]** を選択し、**[サーバー (取り込みサーバー)]** と **[ストリームキー]** を入力します。

   AWS CLI でチャネルを作成した場合:
   + OBS に入力する**サーバー**は、以下の 5 つの組み合わせになります。
     + 取り込みプロトコル: `srt://`
     + CLI レスポンスの `srt` 構造体の**エンドポイント**: 

       `a1b2c3d4e5f6.srt.live-video.net`
     + ポート: `9000`
     + streamid (CLI レスポンスの **streamKey 値**):

       `sk_us-west-2_abcd1234efgh5678ijkl`
     + コンテンツの暗号化に使用されるパスフレーズ。これは、**安全でない取り込み**が有効になっていない場合にのみ使用してください。

       `ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ`

     完全なエントリは次のとおりです。

     `srt://a1b2c3d4e5f6.srt.live-video.net:9000?streamid=sk_us-west-2_abcd1234efgh5678ijkl&passphrase=ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ`
   + OBS に入力する**ストリームキー**は、SRT プロトコルでは空のままになります。

1. **動画出力の解像度**と**ビットレート**については、「*Amazon IVS ストリーミング設定*」の「[チャネルタイプ](streaming-config.md#streaming-config-settings-channel-types)」を参照してください。OBS ウィザードで選択したいずれかの値が Amazon IVS で許可されている値を超える場合は、Amazon IVS への接続に失敗しないように手動で値を調整する必要があります。ウィザードの完了後、次の操作を行います。

   1. 動画の解像度を調整するには、**[Settings > Video > Output (Scaled) Resolution]** (設定 > 動画 > 出力 (スケーリング) 解像度) を使用します。

   1. 動画のビットレートを調整するには、**[Settings > Output > Streaming > Video Bitrate]** (設定 > 出力 > ストリーミング > 動画ビットレート) を使用します。

1. ストリームの安定性を高め、ビューア再生時のバッファリングを回避するために、2 秒間の**キーフレーム間隔**をお勧めします。ウィザードが完了したら、**[設定 > 出力 > 出力モード]** に進み、**[詳細]** を選択し、**[ストリーミング]** タブで **[キーフレーム間隔]** が 2 になっていることを確認します。

1. OBS Studio のメインウィンドウで、[**Start Streaming (ストリーミングの開始)**] を選択します。

OBS の設定は後で手動で変更できます。

1. [**Settings (設定) > Stream (ストリーム)**] を選択します。

1. ドロップダウンから、[**Custom (カスタム)**] を選択します。

1. **サーバー**および/または**ストリームキー**に貼り付けます。

ウィザードはいつでも再実行できます。[**Tools (ツール) > Auto-Configuration Wizard (自動構成ウィザード)**] を選択してください。

オプションで、ライブストリームを**Settings (設定) > General (全般)**にローカルに保存することで、後で使用できます。前述のように、ブロードキャストと AWS 間または AWS 内のネットワークの問題により、ストリームの録画中にデータが失われる可能性があります。このような場合、Amazon IVS は録画よりもライブストリームを優先します。ストリーミングツールでローカルに録画することで、冗長性が得られます。

OBS Studio のアップデートを定期的にチェックして、最新バージョンに更新することをお勧めします。(例えば、「Failed to connect to server」というエラーが表示された場合は、RTMPS をサポートしていない古いバージョンの OBS Studio を使用している可能性があります)

## RTMPS を使用した FFmpeg による録画動画のストリーミング
<a name="ffmpeg-rtmps"></a>

以下の手順に従ってください。

1. FFmpeg をダウンロードしてインストールします。[https://www.ffmpeg.org/download.html](https://www.ffmpeg.org/download.html)。

1. `$VIDEO_FILEPATH`をストリーミングする MP4 動画の場所に設定します。

   ```
   VIDEO_FILEPATH=/home/test/my_video.mp4
   ```

1. `STREAM_KEY`を StreamKey **値**に設定します。

   ```
   STREAM_KEY=sk_us-west-2_abcd1234efgh5678ijkl
   ```

1. (**ingestEndpoint** に `INGEST_ENDPOINT` を設定します (AWS CLI から)。

   ```
   INGEST_ENDPOINT=a1b2c3d4e5f6.global-contribute.live-video.net
   ```

1. 次のターミナルコマンドでストリーミングを開始します (これはすべて 1 行です)。

   ```
   ffmpeg -re -stream_loop -1 -i $VIDEO_FILEPATH -r 30 -c:v libx264 -pix_fmt yuv420p -profile:v main -preset veryfast -x264opts "nal-hrd=cbr:no-scenecut" -minrate 3000 -maxrate 3000 -g 60 -c:a aac -b:a 160k -ac 2 -ar 44100 -f flv rtmps://$INGEST_ENDPOINT:443/app/$STREAM_KEY
   ```

   *上記のコマンドは一例です。プロダクションストリーミングの場合は、必要に応じてパラメータを調整します。*

## SRT を使用した FFmpeg による録画動画のストリーミング
<a name="ffmpeg-srt"></a>

1. FFmpeg をダウンロードしてインストールします。[https://www.ffmpeg.org/download.html](https://www.ffmpeg.org/download.html)。古いまたはコンパイル済みバージョンの FFmpeg を使用している場合は、`--enable-libsrt` フラグを指定した新しいバージョンを構築します。

1. SRT が FFmpeg で使用できることを確認します。次のコマンドを実行し、`libsrt` が出力に含まれていることを確認します。`libsrt` がない場合は、SRT をサポートする新しいバージョンの FFmpeg を再構築または取得します。

   ```
   ffmpeg -version | grep enable-libsrt
   ```

1. `$VIDEO_FILEPATH`をストリーミングする MP4 動画の場所に設定します。

   ```
   VIDEO_FILEPATH=/home/test/my_video.mp4
   ```

1. `STREAM_KEY`を StreamKey **値**に設定します。

   ```
   STREAM_KEY=sk_us-west-2_abcd1234efgh5678ijkl
   ```

1. `INGEST_ENDPOINT` を (`srt` オブジェクトの下にある AWS CLI の) **エンドポイント**に設定します。

   ```
   INGEST_ENDPOINT=a1b2c3d4e5f6.srt.live-video.net
   ```

1. `PASSPHRASE` を (`srt` オブジェクトの下にある AWS CLI の) **パスフレーズ**に設定します。パスフレーズは、チャネルで安全でない取り込みが有効になっていない場合にのみ使用してください。

   ```
   PASSPHRASE=ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ
   ```

1. 次のターミナルコマンドでストリーミングを開始します (これはすべて 1 行です)。

   ```
   ffmpeg -re -i $VIDEO_FILEPATH -c copy -f mpegts "srt://$INGEST_ENDPOINT:9000?streamid=$STREAM_KEY&passphrase=$PASSPHRASE”
   ```

# ステップ 6: ライブストリームの表示
<a name="getting-started-view-stream"></a>

ライブストリームは、以下を使用して表示できます。
+ ネイティブの [IVS Player SDK](#view-stream-player-sdks)。
+ [Amazon IVS コンソール](#view-stream-console)。

## Amazon IVS Player SDK を使用して表示する
<a name="view-stream-player-sdks"></a>

1. IVS Player をセットアップします。[IVS Player SDK の概要](player.md)に関するページを始め、適切なプラットフォーム固有の Player ガイドをお読みください。

1. [Amazon IVS コンソール](https://console.aws.amazon.com/ivs)から、チャネルの作成時に生成された**再生 URL** を取得します。(この*入門*ガイドの前半の「[Final Channel Creation](create-channel-console.md#getting-started-create-channel-console-final-creation)」を参照してください)

1. 再生 URL を使用して `player.load()` を呼び出します。

## Amazon IVS コンソールを使用して表示する
<a name="view-stream-console"></a>

1. [Amazon IVS コンソール](https://console.aws.amazon.com/ivs)を開きます。

   ([AWS マネジメントコンソール](https://console.aws.amazon.com/)から Amazon IVS コンソールにアクセスすることもできます。) 

1. ナビゲーションペインで、[**Live channels**] (ライブチャネル) を選択します。(ナビゲーションペインが折りたたまれている場合は、まずハンバーガーアイコンを選択して開きます。)

1. ストリームを表示するチャネルを選択し、そのチャネルの詳細ページに移動します。

   ライブストリームは、詳細ページの**ライブストリーム**セクションで再生されています。

**注**: コンソールからの再生はリソースを消費するため、ライブ動画出力コストが発生します。詳細については、「IVS 料金表」の「[ライブ動画出力にかかるコスト](https://aws.amazon.com/ivs/pricing/#Live_Video_Output_Costs)」を参照してください。

**注:** ストリーミング開始後、コンソールでストリームを表示できるようになるまでに少し時間がかかります (通常は 30 秒以内)。

# ステップ 7: Service-Quota 制限の確認 (オプション)
<a name="getting-started-check-service-quota"></a>

すべてのアカウントは、同時視聴者と同時ブロードキャストの数に制限があります。*制限が適切であることを確認し、必要に応じて引き上げをリクエストします (特に大規模なストリーミングイベントを計画している場合)*。詳細については、「[IVS Service Quotas](service-quotas.md)」を参照してください。

# ステップ 8: 望ましくないコンテンツと視聴者を防ぐ (推奨)
<a name="getting-started-prevent-undesired-content"></a>

悪意のあるユーザーは、プラットフォーム上で望ましくないコンテンツ (プロスポーツなど) を再ストリーミングしようとしたり、許可なくプラットフォームのストリームを別のウェブサイトに埋め込もうとしたりすることがあります。この種のストリーミングは、ビジネスに価値を付加することなく、アプリケーションが提供するライブストリーミングビデオの量とそれに関連するコストを劇的に増加させる可能性があります。Amazon IVS は、アクティブなストリームを停止するためのコントロールを提供するだけでなく、この種の動作を第一に検出して防止するのに役立つリソースも提供します (「[Undesired Content and Viewers in IVS](undesired-content.md)」を参照してください)。

再生を特定のオリジンおよび/または国に制限するには、再生制限ポリシーを使用します。これらのポリシーはパブリックチャネルでのみ使用できることに注意してください。[IVS の望ましくないコンテンツと閲覧者](undesired-content.md)では、望ましくないコンテンツを制御するためにプライベートチャネルを使用することについても説明します。

再生制限ポリシー (地理的制限など) は、再生認可と同時に使用することはできません。チャネルに対して再生認可が有効になっている場合、設定された再生制限ポリシーは無視されます。プライベートチャネルに地理的制限を適用するには、再生トークンを発行する前に、トークン生成ロジック内のユーザーの位置を検証します。