マルチプレイサーバーからのHTTPリクエスト
ZEPETO World MultiplayサーバーからHTTPリクエストを行うには、ZEPETO.Multiplay.HttpServiceモジュールを使用します。外部ウェブサービスをビジネスロジックの操作、データストレージ、統計分析、エラートラッキングなどに統合してください。
- HTTPSプロトコルのみを使用することを確認してください。HTTPは開発環境でのみサポートされています。
- リクエストはポート80および443でのみ許可されます。
- リクエストおよびレスポンスボディの最大サイズは16KBに制限されています。
- 過剰なリクエストが発生した場合、世界サービスに制限がかかる可能性があるため、1分あたりのリクエスト数を500未満に保ってください。
- 外部ウェブサービスが5秒以内に応答しない場合、リクエストは失敗します。
- レスポンスヘッダーのcontent-typeが、HttpContentType列挙型で定義された値と一致することを確認してください。そうでない場合、リクエストは失敗します。
- さまざまな理由でウェブリクエストが失敗する可能性があるため、防御的にコーディングすることをお勧めします。
📘 次のガイドを参照してください。 [ZEPETO.Multiplay.HttpService API]
方法 | 説明 |
---|---|
HttpService.getAsync(url: string, headers?: HttpHeader): Promise | HTTP GETリクエストを非同期に実行します。 [パラメータ] - url : リクエストを送信するウェブアドレス。 - headers : HTTPリクエストヘッダー。(オプション) [戻り値] - Promise<HttpResponse> : 応答に関する情報を含むHttpResponseオブジェクトをPromiseとして返します。 |
HttpService.postAsync(url: string, body: HttpBodyType, headers?: HttpHeader): Promise | HTTP POSTリクエストを非同期に実行します。 [パラメータ] - url : リクエストを送信するウェブアドレス。 - body : リクエストボディの内容。 - headers : HTTPリクエストヘッダー。(オプション) [戻り値] - Promise<HttpResponse> : 応答に関する情報を含むHttpResponseオブジェクトをPromiseとして返します。 |
HttpService.postAsync(url: string, body: HttpBodyType, httpContentType: HttpContentType, headers?: HttpHeader): Promise | HTTP POSTリクエストを非同期に実行します。 [パラメータ] - url : リクエストを送信するウェブアドレス。 - body : リクエストボディの内容。 - httpContentType : リクエストのContent-Typeヘッダーを指定します。 - headers : HTTPリクエストヘッダー。(オプション) [戻り値] - Promise<HttpResponse> : 応答に関する情報を含むHttpResponseオブジェクトをPromiseとして返します。 このシグネチャを使用する場合、'Content-Type'をヘッダーに追加すると、httpContentTypeで指定された内容に上書きされます。 |
宣言 | 説明 |
---|---|
HttpContentType | HTTPヘッダーのContent-Typeを指定する定数の列挙。 - ApplicationJson : 'application/json' - ApplicationXml : 'application/xml' - ApplicationUrlEncoded : 'application/x-www-form-urlencoded' - TextPlain : 'text/plain' - TextXml : 'text/xml' |
HttpBodyType | HTTPリクエストボディのコンテンツタイプで、文字列または文字列キーと任意の値を持つオブジェクトのいずれかです。 |
HttpHeader | HTTPリクエストヘッダーを定義するためのタイプで、プロパティ値はオブジェクト内の文字列または数値のいずれかです。 |
HttpResponse | HTTPリクエストの結果と応答データに関する情報を含むインターフェース。 - statusCodeHTTP : 応答のステータスコードを表す数値。通常、200は成功したリクエストを示します。 - statusTextHTTP : 応答のステータスメッセージを表す文字列。通常、「OK」は成功したリクエストを示します。 - response : HTTP応答ボディデータを含む文字列。 |
シンプルなGETリクエストの例を作成しましょう。HttpService.getAsync. 新しいクライアントがMultiplay Roomに接続すると、外部ウェブサービスにHTTPリクエストを送信し、結果をログに記録します。
restcountries.com は、さまざまな国に関する情報を提供するオープンAPIです。このサービスを使用して、日本の首都を調べます。
Multiplayを設定し、次にWorld.multiplay/index.tsを開いて、サーバースクリプトを次のように記述します。
📘 次のガイドを参照してください。 [マルチプレイ]
コードの説明:
- クライアントがマルチプレイルームに接続すると、onJoin関数がトリガーされ、findCapitalCityが呼び出されます。
- もし、getAsyncがrestcountries APIに成功した場合、httpResponseオブジェクトにアクセスできます。thenコールバック内で。
- APIレスポンスを解析して、httpResponse.responseをJSON形式からオブジェクトに変換します。
- APIレスポンスの構造を参照することで、必要なプロパティにアクセスし、その値を印刷します。
Unityエディタでマルチプレイサーバーを実行し、シーンを再生すると、コンソールに次の内容が表示されます。
- 一方、導入の注意事項で述べたように、ウェブリクエストは、ウェブアドレスやAPIレスポンス形式の変更など、さまざまな理由で失敗する可能性があります。
- これらのリクエストを適切に処理しないと、World playにさまざまな悪影響を及ぼす可能性があるため、特にHTTPリクエストを扱う際には防御的にコーディングすることをお勧めします。
- 以下は、上記のコードにいくつかの防御的コーディング技術を適用する例です。
ここで適用される防御的コーディング技術には、以下が含まれます:
- 使用する Accept ヘッダー: Accept ヘッダーは、レスポンスボディの期待されるContent-Typeを指定するために使用されます。サーバーによっては、レスポンスのContent-Typeは Accept ヘッダーに基づいて調整されることがあります。
- チェックする HttpResponse.statusCode: HttpResponse.statusCode プロパティは、リクエストの成功を確認するために使用されます。
- JSONデータ構造の検証: JSON.parse を使用して解析されたオブジェクトのデータ構造が期待される構造と一致するか確認します。
- プロパティの存在確認:使用する予定のプロパティがオブジェクトに実際に存在することを確認します。
- Promiseの catch メソッドを利用する:Promiseの catch メソッドは、APIリクエストやレスポンス処理中に発生する可能性のあるエラーを処理するために使用されます。
これらの技術は、予期しないエラーに直面してもコードが信頼性を持って動作するように保護し、その堅牢性を高めます。
HTTPリクエストは、Multiplayサーバーからのみ可能です。
しかし、Multiplayルームメッセージを使用することで、クライアントから外部ウェブサービスにHTTPリクエストを送信するようサーバーをトリガーし、クライアント内でその応答を利用することができます。
以下の例は、クライアントとサーバーの統合を示しています。このデモでは、クライアントのUI上のボタンが押されると、そのボタンに対応する国の首都が表示されます。
📘 以下のガイドを参照してください。 [Multiplay Room Message]
クライアントコード
コードの説明:
- 国名を表示するボタンを反復処理するリスナーを定義します。クリックされると、このリスナーはマルチプレイサーバーにルームメッセージを送信します。
- このリスナーは、ボタンに表示されている国名を 'client-to-server' タイプのメッセージとして送信します。
- 応答を処理するために、'server-to-client' タイプのルームメッセージを受信するためのリスナーも定義します。
- このリスナーは、サーバーから受信した首都名を画面に表示します。複数の首都がある場合は、画面にカンマで区切って表示されます。
サーバーコード
コードの説明:
- クライアントからサーバーへのタイプのマルチプレイルームメッセージを受信したときに呼び出すリスナーを定義します。findCapitalCity。
- 国名を使用してマルチプレイルームメッセージのアドレスを構築し、getAsync呼び出しを行います。
- 呼び出しが成功した場合、応答は以前の例と同様に処理されます。
- restcountries APIの応答から取得した首都名は、サーバーからクライアントへのタイプのルームメッセージとしてクライアントに送信されます。
最後に、HttpService.postAsyncを使用してPOSTリクエストの例を作成しましょう。
postman-echoは、ウェブリクエストから受信したコンテンツを示す構造化された応答を提供するサービスであり、クライアントがリクエストを正しく構成しているかを確認するのに効果的です。
この例を通じて、クエリパラメータ、リクエストボディ、およびヘッダーを持つPOSTリクエストを設定し、リクエストが適切に構成されていることを確認します。
Multiplayを設定し、次にWorld.multiplay/index.tsを開いて、サーバースクリプトを以下のように記述します。
コードの説明:
- クライアントがマルチプレイルームに接続すると、echoPost関数がonJoinトリガーから呼び出されます。
- 次のpostAsyncリクエストを作成する際:
- 最初のパラメータでは、クエリパラメータを含むURL文字列を構築します。
- 2番目のパラメータでは、リクエストボディの内容を設定します。
- 4番目のパラメータでは、リクエストヘッダーを設定します。
- リクエストボディがJSON形式であることを指定するために、3番目のパラメータに'application/json' Content-Typeを設定します。
- もしpostAsync呼び出しが成功した場合、httpResponseオブジェクトにアクセスできます。その後コールバック。
- 私たちはhttpResponse.responseを解析して、APIのレスポンスをJSON形式からオブジェクトに変換します。
- APIレスポンスの構造を参照し、コンソール出力を使用して、HTTPリクエストのクエリパラメータ、リクエストボディ、およびリクエストヘッダーが正しく設定されているかを確認します。
UnityエディタでMultiplayサーバーを実行し、シーンを再生すると、コンソールに以下が表示されます。