7.18. 応用機能 - マッチメイクセッション参加者数取得機能

マッチメイクセッション参加者数取得機能とは、メッシュを構築しているマッチメイクセッションに参加しているステーション数を取得する機能です。nn::pia::session::Session::GetMatchmakeSessionStationNum() で取得できます。

セッション参加募集の締め切り時の新規参加者の検知

セッション参加募集の締め切り直前にステーションが参加してきた場合、セッション参加募集を締め切った後に参加してくる可能性があります。セッション参加募集を締め切り、次のシーンに処理を進める前に本関数と nn::pia::session::Session::GetStationNum() の値を比較することで新規参加者が存在する可能性を検知できます。ただし、同じタイミングでセッションから離脱するステーションが存在した場合は一時的に検知できない状態になるため、離脱完了後に確認する必要があります。

nn::pia::session::Session::CloseSessionAsync() は非同期処理中にこの確認処理を行っています。

対象となるマッチメイクセッション

本機能で参加者取得の対象となるマッチメイクセッションは nn::pia::session::Session::GetStatus() の状態に応じて変わります。

nn::pia::session::Session::Status_ConnectedSession が返る状態では参加しているセッションが対象となります。
nn::pia::session::Session::Status_ConnectedJointSession が返る状態では参加しているジョイントセッションが対象となります。

また、nn::pia::session::Session::Status_MigratingSession が返る状態では取得する参加者数が不定な値になります。