1.23.0 から 1.24.0 へのアップグレード¶

Unity Asset Package の変更¶

Genvid Unity Asset Package を 2 つに分割しました。一方は Genvid SDK をゲームに統合することができます。もう一方は、クラスタを操作するためのツールを Unity Editor インターフェイスに追加します。

1.24.0 にアップグレードする前に、古いバージョンの Genvid アセットパッケージを完全にアンインストールしてください。

Unity Cube サンプルの変更¶

ストリームで通知が送信されたため、Genvid_SubmitNotification() メソッドのファミリーを GenvidStreams から GenvidSession に移動しました。
Submit* メソッドのエラー処理を一貫性のあるものにし、情報量を増やしました。

YouTube 埋め込みプレイヤーと SSL サポート¶

YouTube 埋め込みプレイヤーを使用するには、SSL で保護された Web サイトが必要になりました。つまり、SSL が使用されていることが末尾で分かる名前 (_alb_ssl など) の SSL クラスタを使用する必要があります。

SSL モジュールを使用する場合は、 /samples/cube/web/web.py の loadEndpoint() メソッドを使用して、クラスタ構成で leaf エンドポイントと Web エンドポイントをロードする必要があります。

    def loadEndpoint(self):
        leaf_endpoint = self.get_leaf_endpoint()
        web_endpoint = self.get_web_endpoint()
        config = {
            'version': '1.7.0',
            'config': {
                'cloud': {
                    'endpoint': {
                        'leaf': '',
                        'web': ''
                    }
                }
            }
        }
        config['config']['cloud']['endpoint']['leaf'] = leaf_endpoint
        config['config']['cloud']['endpoint']['web'] = web_endpoint
        return config

Web サイトに埋め込まれた YouTube を SSL YouTube でストリーミングするには、samples/streaming_services にあるファイル youtube.sample.hcl をクラスタ構成に読み込む必要があります。このファイルには、embed_ssl を true に設定することで、SSL による埋め込みを可能にする新しい設定が含まれています。

config {
  embed_ssl {
    enabled = false
  }
} // end of config

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

Web サンプルの読み込み時に、ローカルクラスタ用の自己署名 SSL 証明書を生成できるようになりました。新しい python スクリプト /py-genvid-toolbox/genvid/toolbox/generate_ssl.py は、HashiCorp Vault を使用して、Web サンプルのバックエンドが使用する証明書を生成します。

#The file kept for the purpose of generating documentation for upgrade-1.24.0.rst The functionality has been moved to ssl.py.

web サンプルをロードする際に -s オプションを使用すると generate_ssl.py スクリプトが起動します。

py web.py load -s

スタンドアロンモードを使用している場合でも、ストリーミングプラットフォームを使用している場合でも、SSL による埋め込みを有効にするには、hcl ファイルで embed_ssl を**true** に設定してください。

config {
  embed_ssl {
    enabled = true
  }
}

警告

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

Terraform モジュールの変更内容¶

AWS Terraform の全モジュールから変数 force_az を削除しました。新しい変数 azs に置き換え、特定のアベイラビリティゾーンを選択できるようにしました。
AWS Terraform のモジュールに変数 subnet_ids を追加しました。これは AWS のサブネット ID の順番リストです。モジュールは、この変数に指定したリストを使用します。リストを提供しない場合、モジュールは変数 azs の各アベイラビリティゾーンの最初のサブネットを使用します。
モジュール azurerm_basic_cluster は、クラスタのインスタンス化を高速化するために Azure Shared Image Version を使用するようになりました。

アップグレード後に既存のクラスタでアベイラビリティゾーンが保持されていることを確認するには以下の方法があります。

force_az の値をメモしておく
モジュールを再インポートする
Cluster 設定ページを開く
force_az の値を azs 設定に追加する

genvidClient.IDataFrame.timeCode adjustment¶

genvidClient.IDataFrame.timeCode を genvidClient.IDataStreamFrame.timeCode に合わせてミリ秒に変換しました (バージョン 1.23.0 では、フォーマットが一致していませんでした)。