初期化と終了¶
Strixネットワークの初期化¶
Strixのネットワーク機能を使用する前にネットワークを初期化する必要があります。これは、Initialize Strix Network関数を呼び出して、引数としてアプリケーションIDを入力することで行います。
サーバーで認可を有効にしている場合は、初期化には別の関数Initialize Strix Network with Http Access Tokenを使用します。この関数は、追加の引数としてアクセストークンを受け取ることに注意してください。詳しくはトークン認証(OAuth)を参照してください。
どちらの関数でもApplication Idの指定は必須です。Initialize Strix Network with Http Access Tokenでは、Access Tokenも必須です。
注釈
Strixネットワークが初期化されているときにどちらかの関数を呼ぶと、その呼び出しは単に無視されます。そのため、これらの関数は安全に何回も呼び出すことができます。しかしその結果、単に別のアプリケーションIDを指定してInitialize Strix Networkを呼び出しても、アプリケーションIDが異なる別のサーバーシステムに切り替えることは(そうする必要があったとしても)できません。切り替える前にStrixネットワークを停止する必要があります。
Strixネットワークの停止¶
Stop Strix Network関数は、Strixの全てのネットワーク操作を停止し、全ての接続を閉じます。これは、ゲームのネットワークを利用する最後の部分で呼び出すべきです。ただし、ネットワークを停止して再起動することで、別のクラスターに変更することもできます。
Strixネットワークの状態確認¶
StrixBPLibraryカテゴリーにあるIs Initialized関数を呼び出すと、Strixネットワークが初期化されているかどうかを調べることができます。この関数は、Strixネットワークが初期化されていればTrueを、そうでなければFalseを返します。ここで調べるのは初期化の状態のみである点に注意してください。このクライアントが実際にいずれかのサーバーに接続しているかどうかには関係ありません。