Xbox Live 매치메이킹: 세션 설정하기
이 문서에서는 Xbox Live의 매치메이킹 기능 중 하나인 xboxlive_matchmaking_set_joinable_session 함수에 대해 설명합니다. 이 함수는 사용자가 다른 사용자들이 참여할 수 있도록 세션을 설정하는 데 사용됩니다.
함수 설명
xboxlive_matchmaking_set_joinable_session 함수는 이전에 생성된 세션을 다른 사용자가 시스템 UI를 통해 참여할 수 있도록 설정합니다. 사용자는 한 번에 하나의 참여 가능한 세션만 가질 수 있으며, 사용자가 세션을 떠나거나 세션이 종료되면 이 설정은 자동으로 해제됩니다. 그러나 세션 인수로 -1을 전달하여 수동으로 해제할 수도 있습니다.
문법
xboxlive_matchmaking_set_joinable_session(local_user, session_that_is_joinable);
인수 설명
| 인수 | 유형 | 설명 |
|---|---|---|
| local_user | 사용자 ID 포인터 | 현재 로컬 사용자 ID를 나타냅니다. |
| session_that_is_joinable | 세션 ID | 참여 가능하게 만들 세션 ID 또는 -1입니다. |
반환값
이 함수는 반환값이 없습니다.
예제 코드
아래 코드는 유효한 세션 ID 값이 있는지 확인하고, 감지되면 세션을 참여 가능하게 설정합니다.
if (global.session_ID != -1) {
xboxlive_matchmaking_set_joinable_session(xboxlive_user_for_pad(0), global.session_ID);
}
활용 예제
- 세션 생성 후 참여 가능 설정하기
gml // 세션 생성 코드 global.session_ID = create_session(); // 세션을 참여 가능하게 설정 xboxlive_matchmaking_set_joinable_session(xboxlive_user_for_pad(0), global.session_ID); - 세션 종료 시 참여 불가 설정하기
gml // 세션 종료 코드 end_session(global.session_ID); // 세션을 참여 불가로 설정 xboxlive_matchmaking_set_joinable_session(xboxlive_user_for_pad(0), -1); - 다른 사용자와의 매치메이킹을 위한 세션 설정
gml // 다른 사용자와의 매치메이킹을 위한 세션 설정 if (is_user_ready()) { xboxlive_matchmaking_set_joinable_session(xboxlive_user_for_pad(1), global.session_ID); } - 세션 상태 확인 후 참여 가능 설정
gml // 세션 상태 확인 후 참여 가능 설정 if (check_session_status(global.session_ID)) { xboxlive_matchmaking_set_joinable_session(xboxlive_user_for_pad(0), global.session_ID); }
이와 같이 xboxlive_matchmaking_set_joinable_session 함수를 활용하여 세션을 설정하고 관리할 수 있습니다.