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を持つタスク