Web サンプル

Cube Samples のいずれかを設定した後、ストリームを表示してゲームデータを使用するために、Genvid API を適切に呼び出すことができる Web サイトが必要です。また、ゲームと対話するためには、Genvid API を介して特定の呼び出しを行う必要があります。

Web サンプルは、 DirectXUnreal、 または Unity に任意の キューブサンプル をストリーミングするための Web サイトを作成するものです。これは、 Cluster UI Jobs ページにサービスとして表示されます。これには、 CUBE SAMPLE リンクと CUBE ADMIN リンクが含まれます。

これらのリンクは、実行中の DirectX、Unreal、または Unity のサンプルをストリーミングする Web サイトにリダイレクトします。 CUBE SAMPLE リンクはユーザーとしてリダイレクトし、CUBE ADMIN リンクは管理者としてリダイレクトします。

使用するためには、ビルドしてからロードする必要があります。

  1. /samples/cube/web ディレクトリに移動します。

  2. Web サイトを構築します。

    py web.py build
    
  3. Web サイトを読み込みます。

    py web.py load
    

ローカルクラスタでの SSL サポート

Web サンプルの読み込み時に、ローカルクラスタ用の自己署名 SSL 認証を生成することが可能になりました。HashiCorp Vault は Web サンプル のバックエンドで使われる認証を生成します。

以下のコマンドを使用して、Web サンプルが見つけることができる /samples/cube/web に証明書を生成します。また、このコマンドは Cluster UI Jobs ページに https リンクを作成します。

py web.py load --ssl

または

py web.py load -s

SSL 認証のみを生成するために以下のコマンドも使えます。

genvid-sdk generate-ssl

スタンドアロンモードでも YouTube などのストリーミングプラットフォームでも、embed_ssl を true に設定して SSL での埋め込みを可能にする新しい設定が hcl ファイルに含まれていることを確認してください。

config {
   embed_ssl {
      enabled = true
   }
}

警告

クラウドで SSL を使っている場合でも、ローカルクラスタで SSL を使っている場合でも、もし、embed_ssl キーを含む複数の hcl 設定ファイル ( twitch.sample.hcl`や`youtube.sample.hcl など) を読み込む必要がある場合は、必ずウェブサンプルの読み込み後 に読み込むようにしてください。そうしないと、embed_ssl キーに関連付けられた値を上書きしてしまう可能性があります。

ここでは、Web サンプルの作成方法を順を追って説明します。プロジェクトに役立つと思われるサンプルコードは、ご自由にご利用ください。