class RoomManagementService

(Niantic.Lightship.SharedAR.Rooms.RoomManagementService)

概要

RoomManagementServiceは、ルーム管理サービスのバックエンドにアクセスし、ルームを作成、削除、検索するためのインターフェイスを提供します。 ルームとは、サーバーを中継したネットワークで複数のピア同士を接続するためのエンティティである。

class RoomManagementService {
	public：
	
		struct GetOrCreateRoomAsyncTaskResult;

		// methods
	
		static RoomManagementServiceStatus CreateRoom(
			RoomParams roomParams,
			out IRoom outRoom
		);
	
		static RoomManagementServiceStatus DeleteRoom(string roomId)；
		static RoomManagementServiceStatus GetRoom(string roomId, out IRoom outRoom);
	
		static RoomManagementServiceStatus QueryRoomsByName(
			string name,
			out List<IRoom> rooms
		);
	
		static RoomManagementServiceStatus GetAllRooms(out List<IRoom> rooms)；
	
		static RoomManagementServiceStatus GetOrCreateRoomForName(
			RoomParams roomParams,
			out IRoom outRoom
		);
	
		static void GetOrCreateRoomAsync(
			string roomName,
			string roomDesc,
			uint roomCapacity,
			GetOrCreateRoomCallback doneCb
		)；
	
		static async Task<GetOrCreateRoomAsyncTaskResult> GetOrCreateRoomAsync(
			string roomName,
			string roomDescription,
			uint roomCapacity
		);
	
		delegate void GetOrCreateRoomCallback(
			RoomManagementServiceStatus status,
			string room_id
		);
}；

詳細資料

RoomManagementServiceは、Room Management Serviceのバックエンドにアクセスし、Roomを作成、削除、検索するためのインターフェイスを提供します。 ルームとは、サーバーを中継したネットワークで複数のピア同士を接続するためのエンティティである。

メソッド

CreateRoom

static RoomManagementServiceStatus CreateRoom(
		RoomParams roomParams,
		out IRoom outRoom
)

サーバーに新しいルームを作る。

    Parameters:

    roomParams - roomのパラメーター

    outRoom - IRoom オブジェクトとして作成されたルーム 作成に失敗した場合は null。

    戻り値:

    操作のステータス

DeleteRoom

static RoomManagementServiceStatus DeleteRoom(string roomId)

サーバー上のルームを削除する。

    Parameters:

    roomId - 削除するルームのID。

    戻り値:

    操作のステータス

GetRoom

static RoomManagementServiceStatus GetRoom(string roomId, out IRoom outRoom)

サーバー上のRoom IDでルームを取得する

    Parameters:

    roomId - RoomのID（文字列）。

    outRoom - 検出されたRoomオブジェクト。 操作に失敗した場合、またはルームIDが見つからない場合はNULL<//param>

    戻り値

    操作のステータス

QueryRoomsByName

static RoomManagementServiceStatus QueryRoomsByName(
		string name,
		out List<IRoom> rooms
)

サーバー上のルームをルーム名で検索します。

    Parameters:

    name - 検索するルームの名前

    rooms - ルーム名が一致するルームのリスト

    戻り値

    操作のステータス

GetAllRooms

静的 RoomManagementServiceStatus GetAllRooms(out List<IRoom> rooms)

このアプリによって作成されたサーバー上のすべてのルームを取得します。

    Parameters:

    rooms - このアプリで利用可能なルームのリスト

    戻り値

    操作のステータス

GetOrCreateRoomForName

static RoomManagementServiceStatus GetOrCreateRoomForName(
		RoomParams roomParams,
		out IRoom outRoom
)

サーバー上の指定された名前のIRoomオブジェクトを取得します。 その名前のルームが見つからない場合、与えられたルームパラメーターを使用して新しいルームを作成します。

    Parameters:

    roomParams - 取得または作成するルームのパラメーター

    outRoom - IRoom オブジェクト。 サーバー操作に失敗した場合はnull

    戻り値

    操作のステータス

GetOrCreateRoomAsync

static void GetOrCreateRoomAsync(
		string roomName,
		string roomDesc,
		uint roomCapacity,
		GetOrCreateRoomCallback doneCb
)

GetOrCreateRoom リクエストの非同期実装。 この関数は、"roomName "という名前のルームが存在するかどうかをチェックし、存在しない場合はルームを作成する。 この関数は、これらの操作のいずれかによって有効なRoomIDを取得すると、"doneCb "を介してそれを返します。 "doneCb"には2つのパラメータがある。 1つ目のパラメーターは、サービスに問題があった場合のレスポンスコードで、2つ目のパラメーターは、発見/作成されたルームIDです。

    Parameters:

    roomName - チェックする部屋名。

    roomDesc`` - 部屋の説明が必要な場合に使用する。

    roomCapacity - ルームを作る必要がある場合に使用するルームの収容人数。

    doneCb - 関数がエラーになった後、または有効なルームIDを受け取った後に呼び出されるコールバック。

GetOrCreateRoomAsync

static async Task<GetOrCreateRoomAsyncTaskResult> GetOrCreateRoomAsync(
		string roomName,
		string roomDescription,
		uint roomCapacity
)

GetOrCreateRoom リクエストの非同期実装。 この関数は、"roomName "という名前のルームが存在するかどうかをチェックし、存在しない場合はルームを作成する。 このバリアントはタスクを返すので、C# の async/await 機能で await することができる。 タスクは2つの結果を受け取る。リクエストのステータスと、成功した場合、リクエストのroomIdである。

    Parameters:

    roomName - 確認するルーム名

    roomDescription - ルームの説明が必要な場合に使用する。

    roomCapacity - ルームを作る必要がある場合に使用するルームの収容人数。

    戻り値

    リクエストステータスとリクエスト成功時のroomIdを持つタスク