Google.Maps.PlayableLocationsService

プレイアブル ロケーションを使用するためのエントリ ポイント。

概要

継承

継承元: MonoBehaviour

公開タイプ

BadLocationReason{
  Other,
  NotPedestrianAccessible,
  NotOpenToPublic,
  PermanentlyClosed
}
enum
不適切なプレイアブル ロケーションを報告する理由。

公開関数

ReportBadPoint(string placeId, BadLocationReason reason, string reasonDetails, ReportBadPointStatusCallback statusCallback)
void
不適切な場所のレポートをサーバーに送信しようとするコルーチンを返します。
ReportInteractedPlace(int gameObjectType, string placeId)
void
ユーザーがこのプレイアブル ロケーションに配置されたゲーム オブジェクトを操作したことをレポートします。
ReportPresentedPlace(int gameObjectType, string placeId)
void
このプレイアブル ロケーションに配置されたゲーム オブジェクトがユーザーに表示されたことをレポートします。

クラス

Google.Maps.PlayableLocationsService.ReportBadPointStatus

不適切な場所のレポート送信のための完了済みリクエストのステータスをカプセル化します。

公開タイプ

BadLocationReason

 BadLocationReason

不適切なプレイアブル ロケーションを報告する理由。

プロパティ
NotOpenToPublic

Location はすべての人に公開されているわけではありません。たとえば、私有のオフィスビルです。

NotPedestrianAccessible

歩行者は Location にアクセスできません。たとえば、ロケーションは高速道路の真ん中にあります。

Other

理由が次のリストに含まれていません。クライアントは reasonDetails に詳細を提供する必要があります。

PermanentlyClosed

Location は閉業しています。たとえば、そのロケーションの店舗は閉店しています。

公開関数

ReportBadPoint

void ReportBadPoint(
  string placeId,
  BadLocationReason reason,
  string reasonDetails,
  ReportBadPointStatusCallback statusCallback
)

不適切な場所のレポートをサーバーに送信しようとするコルーチンを返します。

返されたコルーチンは、StartCoroutine を直接使用して始めるか、イールドを使用して別のコルーチンから返す必要があります。

コルーチンが終了すると、指定された ReportBadPointStatus オブジェクトにリクエストが成功したかどうかの情報が入力されます。内部的には、ネットワーク リクエストは失敗した場合に複数回再試行されます。

注: OTHER と TEMPORariLY_INAccessIBLE の理由では、reasonDetails を空にできません。

詳細
パラメータ
placeId
レポートする場所の ID。
reason
これがゲームプレイにとって不適切な場所である主な理由。
reasonDetails
ユーザーがこの場所をレポートした理由を説明する自由形式のテキスト。
statusCallback
リクエストの完了時に呼び出すコールバック。

ReportInteractedPlace

void ReportInteractedPlace(
  int gameObjectType,
  string placeId
)

ユーザーがこのプレイアブル ロケーションに配置されたゲーム オブジェクトを操作したことをレポートします。

gameObjectType について詳しくは、ReportPresentedPlace() をご覧ください。

詳細
パラメータ
gameObjectType
このプレイアブル ロケーションに配置されるゲーム オブジェクトのタイプ。
placeId
場所の ID。

ReportPresentedPlace

void ReportPresentedPlace(
  int gameObjectType,
  string placeId
)

このプレイアブル ロケーションに配置されたゲーム オブジェクトがユーザーに表示されたことをレポートします。

Google は ReportPresentedPlaceReportInteractedPlace に記録された情報を使って、異なるプレイアブル ロケーションに配置されたゲーム オブジェクトがプレーヤーによってアクセスされる頻度を比較し、プレイアブル ロケーションの品質向上を図ます。

ゲーム オブジェクトの種類(例: モンスターやパワーアップ)のアクセス頻度は異なるため、各プレイアブル ロケーションに gameObjectType を割り当てる(例: モンスター=0、パワーアップ=1)ことで、レポートを比較可能なイベントに分類します。固有のゲーム オブジェクトの種類は少なく(10 個以下を推奨)してください。

このメソッドは、同じ Place ID で繰り返し呼び出すことができます。場所が以前に報告されていない場合、または前回のレポート以降にプレーヤーがプレイアブル ロケーションに配置されたゲーム オブジェクトを操作した場合に、場所はサーバーにレポートされます。

注: 「表示」の意味は、一貫して使用すれば自由に定義できます。たとえば、プレイアブル ロケーションがプレーヤーから 500 m 以内にある場合に「表示」されたと定義することができます。

詳細
パラメータ
gameObjectType
このプレイアブル ロケーションに配置されるゲーム オブジェクトのタイプ。
placeId
場所の ID。