/// <summary>
/// ギャザリングを新規作成<br />
/// <br />
/// Player に指定する自身のプレイヤー情報のユーザIDは省略できます。<br />
/// expiresAtを指定することでギャザリングの有効期限を設定することができます。<br />
/// 有効期限を用いない場合、古いギャザリングが残り続けマッチングが成立したときには、<br />
/// ユーザーがゲームから離脱している可能性があります。<br />
/// 有効期限を用いる場合は、有効期限が来るたびにユーザーにギャザリングの再作成を促す仕組みにしてください。<br />
/// </summary>
///
/// <returns>IEnumerator</returns>
/// <param name="callback">コールバックハンドラ</param>
/// <param name="session">ゲームセッション</param>
/// <param name="namespaceName">ネームスペース名</param>
/// <param name="player">自身のプレイヤー情報</param>
/// <param name="attributeRanges">募集条件</param>
/// <param name="capacityOfRoles">参加者</param>
/// <param name="allowUserIds">参加を許可するユーザIDリスト</param>
/// <param name="expiresAt">ギャザリングの有効期限</param>
public IEnumerator CreateGathering(
UnityAction <AsyncResult <EzCreateGatheringResult> > callback,
GameSession session,
string namespaceName,
EzPlayer player,
List <EzCapacityOfRole> capacityOfRoles,
List <string> allowUserIds,
List <EzAttributeRange> attributeRanges = null,
long?expiresAt = null
)
{
yield return(_profile.Run(
callback,
session,
cb => _client.CreateGathering(
new CreateGatheringRequest()
.WithNamespaceName(namespaceName)
.WithPlayer(player.ToModel())
.WithAttributeRanges(attributeRanges != null ? attributeRanges.Select(item => item?.ToModel()).ToList() : new List <AttributeRange>(new AttributeRange[] {}))
.WithCapacityOfRoles(capacityOfRoles != null ? capacityOfRoles.Select(item => item?.ToModel()).ToList() : new List <CapacityOfRole>(new CapacityOfRole[] {}))
.WithAllowUserIds(allowUserIds)
.WithExpiresAt(expiresAt)
.WithAccessToken(session.AccessToken.token),
r => cb.Invoke(
new AsyncResult <EzCreateGatheringResult>(
r.Result == null ? null : new EzCreateGatheringResult(r.Result),
r.Error
)
)
)
));
}
/// <summary>
/// すでに存在する中で、自分が参加できるギャザリングを探して参加<br />
/// <br />
/// 一定時間 検索を行い、対象が見つからなかったときには `マッチメイキングの状態を保持するトークン` を返す。<br />
/// 次回 `マッチメイキングの状態を保持するトークン` をつけて再度リクエストを出すことで、前回の続きから検索処理を再開できる。<br />
/// すべてのギャザリングを検索したが、参加できるギャザリングが存在しなかった場合はギャザリングもトークンもどちらも `null` が応答される。<br />
/// </summary>
///
/// <returns>IEnumerator</returns>
/// <param name="callback">コールバックハンドラ</param>
/// <param name="session">ゲームセッション</param>
/// <param name="namespaceName">ネームスペース名</param>
/// <param name="player">自身のプレイヤー情報</param>
/// <param name="matchmakingContextToken">検索の再開に使用する マッチメイキングの状態を保持するトークン</param>
public IEnumerator DoMatchmaking(
UnityAction <AsyncResult <EzDoMatchmakingResult> > callback,
GameSession session,
string namespaceName,
EzPlayer player,
string matchmakingContextToken = null
)
{
yield return(_profile.Run(
callback,
session,
cb => _client.DoMatchmaking(
new DoMatchmakingRequest()
.WithNamespaceName(namespaceName)
.WithPlayer(player.ToModel())
.WithMatchmakingContextToken(matchmakingContextToken)
.WithAccessToken(session.AccessToken.token),
r => cb.Invoke(
new AsyncResult <EzDoMatchmakingResult>(
r.Result == null ? null : new EzDoMatchmakingResult(r.Result),
r.Error
)
)
)
));
}