翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon GameLift Streams を使用したウェブサーバーとクライアントのセットアップ
<a name="setting-up-web-sdk"></a>

 このチュートリアルでは、Amazon GameLift Streams のストリーミングサービスを統合するウェブクライアントアプリケーションを設定します。次に、Amazon GameLift Streams Web SDK、JavaScript ライブラリ、および開始できるサンプルコードを使用します。サンプルコードには、シンプルな Amazon GameLift Streams バックエンドウェブサーバーとシンプルなウェブクライアントが含まれています。このチュートリアルを終了すると、サンプルコードを使用してストリームを開始できます。

 Amazon GameLift Streams を初めて使用する場合は、[Amazon GameLift Streams で最初のストリームを開始する](streaming-process.md)Amazon S3 にゲームをアップロードし、ブラウザの Amazon GameLift Streams コンソール内からストリーミングをテストするチュートリアルから始めることを強くお勧めします。

## 前提条件
<a name="setting-up-web-sdk-prereq"></a>
+ プログラムによるアクセスに適切な認証情報を持つ AWS アカウント。詳細については、「[開発者としての Amazon GameLift Streams のセットアップ](setting-up.md)」を参照してください。
+ AWS SDK。
+ Amazon GameLift Streams がサポートするウェブブラウザ — 「」を参照してください[サポートされているブラウザと入力](sdk-browsers-input.md)。
+ Node.js — [Node.js ダウンロード](https://nodejs.org/en/download)ページを参照してください。

## Web SDK のダウンロード
<a name="setting-up-web-sdk-materials"></a>

このチュートリアルでは、[入門製品ページの](https://aws.amazon.com/gamelift/streams/getting-started/)リソースセクションから次のマテリアルをダウンロードする必要があります。
+ **Amazon GameLift Streams Web SDK バンドル**: これには、シンプルなバックエンドサービスとウェブクライアントのサンプルコードが含まれます。
+ **Amazon GameLift Streams Web SDK API リファレンス**: この API リファレンスは、JavaScript 用の Amazon GameLift Streams API ラッパーを文書化します。

## ストリーミングリソースをセットアップする
<a name="setting-up-web-sdk-resources"></a>

ストリームを開始するには、アプリケーションとストリームグループというストリームリソースが必要です。具体的には、以下が必要です。
+  **準備完了**ステータスのアプリケーション。
+  使用可能なストリーム容量を持つ**アクティブ**ステータスのストリームグループ。
+  プライマリロケーション以外のロケーションでのストリーミングの場合、アプリケーションはそのロケーションへのレプリケーションを完了している必要があります。

 Amazon GameLift Streams コンソールまたは Amazon GameLift Streams CLI を使用してアプリケーションとストリームグループを設定するには、[Amazon GameLift Streams ストリームグループを使用してストリーミングを管理する](stream-groups.md)それぞれ [Amazon GameLift Streams でアプリケーションを準備する](applications.md)と を参照してください。または、Amazon GameLift Streams コンソールでのend-to-endのチュートリアルについては、「」を参照してください[Amazon GameLift Streams で最初のストリームを開始する](streaming-process.md)。

## バックエンドサーバーをセットアップする
<a name="setting-up-web-sdk-backend"></a>

 バックエンドサーバーは、ユーザーの認証、ストリームパラメータの設定、エンドユーザーに代わって Amazon GameLift Streams サービス API コールの実行などのタスクを処理します。セットアップの詳細については、サンプルコードと Amazon GameLift Streams Web SDK API リファレンスを参照してください。具体的には、Amazon GameLift Streams Web SDK パッケージの server.js ファイルを参照してください。

**重要**  
 このコードはテストおよび評価のみを目的としたサンプルコードであり、本番稼働用容量では使用しないでください。

**サンプルバックエンドサービスを実行するには**

1.  ターミナルまたはコマンドプロンプトを開き、フォルダ に移動します`AmazonGameLiftStreamsWebSDK\GameLiftStreamsSampleGamePublisherService\`。

1.  以下の コマンドを実行します。

   ```
   npm install
   node server.js
   ```

 サンプルバックエンドサービスを実行すると、エンドユーザーはウェブクライアントを介してストリームに接続できます。次のステップでウェブクライアントをテストします。

## ウェブクライアントを起動する
<a name="setting-up-web-sdk-client"></a>

ウェブクライアントアプリケーションは、Amazon GameLift Streams ストリームの受信とデコード、エンドユーザーへのストリーミング、エンドユーザーがアプリケーションとやり取りするためのウェブブラウザ UI の提供を担当します。JavaScript Amazon GameLift Streams Web SDK を独自のウェブクライアントアプリケーションに統合する方法の詳細については、サンプルコードと Amazon GameLift Streams Web SDK API リファレンスを参照してください。具体的には、Amazon GameLift Streams Web SDK パッケージ`public/index.html`の「」を参照してください。ブラウザでウェブクライアントを起動するときに、ウェブページのソースを確認することもできます。

**注記**  
Amazon GameLift Streams の Windows ランタイムは、IPv4 または IPv6 経由のストリームセッションをサポートします。ただし、Linux および Proton ランタイム環境は IPv4 経由のストリーミングのみをサポートします。

**ウェブクライアントアプリケーションを起動するには**

1.  ウェブブラウザを開き、 に移動します`http://localhost:port/`。ポート番号はバックエンドサーバーによって設定されます。デフォルトでは、これは HTTP ポート 8000 です。

1. ゲームをプレイするか、ソフトウェアを使用します。

   1. マウスなどの入力をアタッチするには、**入力をア**タッチを選択します。

   1. ゲームを終了するには、**Esc** キーを選択します。

   1. サーバープロセスを停止するには、**Ctrl\$1C** キーを選択します。

## ストリーミングリソースをクリーンアップする
<a name="setting-up-web-sdk-cleanup"></a>

**警告**  
 ストリームグループがストリーミング容量を割り当てた場合、その容量が未使用であってもコストが発生します。不要なコストを回避するには、ストリームグループを必要なサイズにスケールします。開発時には、ストリームグループの常時オン容量とターゲットアイドル容量を、使用していないときはゼロにスケーリングすることをお勧めします。詳細については、[ストリームグループを容量ゼロにスケールする](pricing.md#pricing-pause-stream-groups) を参照してください。

チュートリアルを完了し、アプリケーションをストリーミングする必要がなくなったら、以下の手順に従って Amazon GameLift Streams リソースをクリーンアップします。

**ストリームグループの削除**

 ストリームグループを削除すると、Amazon GameLift Streams はすべてのストリーム容量を解放するように動作します。

**Amazon GameLift Streams コンソールを使用してストリームグループを削除するには**

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

1.  既存のストリームグループのリストを表示するには、ナビゲーションペインでストリーム**グループ**を選択します。

1.  削除するストリームグループの名前を選択します。

1.  ストリームグループの詳細ページで、**削除**を選択します。

1.  **削除**ダイアログボックスで、削除アクションを確認します。

 Amazon GameLift Streams は、コンピューティングリソースのリリースとストリームグループの削除を開始します。この間、ストリームグループは**削除**ステータスになります。Amazon GameLift Streams がストリームグループを削除すると、そのグループを取得できなくなります。

**アプリケーションの削除**

 削除できるのは、以下の条件を満たすアプリケーションだけです。
+  **[準備完了]** 状態または **[エラー]** 状態のアプリケーション。
+  進行中のどのストリームセッションでもストリーミングされていないアプリケーション。クライアントがストリームセッションを終了するまで待つか、Amazon GameLift Streams API の [TerminateStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_TerminateStreamSession.html) を呼び出してストリームを終了する必要があります。

 アプリケーションがいずれかのストリームグループにリンクされている場合は、削除する前に、関連するすべてのストリームグループからリンクを解除する必要があります。コンソールでは、このプロセスを説明するダイアログボックスが表示されます。

**Amazon GameLift Streams コンソールを使用してアプリケーションを削除するには**

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

1. ナビゲーションバーで、**アプリケーション**を選択して既存のアプリケーションのリストを表示します。削除するアプリケーションを選択します。

1. アプリケーションの詳細ページで、**削除**を選択します。

1. **削除**ダイアログボックスで、削除アクションを確認します。

 Amazon GameLift Streams がアプリケーションの削除を開始します。この間、アプリケーションは `Deleting`ステータスになります。Amazon GameLift Streams がアプリケーションを削除すると、アプリケーションを取得できなくなります。