사용자 및 계정
이 섹션은 Xbox 플랫폼을 대상으로 하는 사용자들을 위한 것으로, 사용자 및 사용자 계정과 관련된 Xbox Live 기능을 설명합니다.
Xbox One에서는 여러 사용자가 동시에 콘솔에 로그인할 수 있습니다. 각 사용자마다 특정 컨트롤러가 연결되어 있으며, 저장된 게임 데이터도 사용자별로 관리됩니다. 이 시스템을 최대한 활용하기 위해 GameMaker는 컨트롤러와 사용자 간의 연관성에 관련된 여러 Xbox One 전용 기능을 도입했습니다. 이를 통해 사용자에 대한 정보를 조회하고, 사용자별로 저장 데이터가 어떻게 처리되는지를 제어할 수 있습니다. 이 시스템에 대한 더 많은 개발자 정보는 Microsoft 개발자 사이트의 공식 백서에서 확인할 수 있습니다.
참고: 사용자 ID는 각 개인에게 고유하며, 서로 다른 콘솔 간에도 지속됩니다. 따라서 동일한 사용자가 두 개의 다른 장치에 로그인하면 이 사용자 ID는 동일합니다.
Xbox Live 계정과 함께 사용할 수 있는 함수 목록
| 함수 이름 | 설명 |
|---|---|
| xboxlive_user_is_signed_in | 사용자가 로그인했는지 확인합니다. |
| xboxlive_user_is_signing_in | 사용자가 로그인 중인지 확인합니다. |
| xboxlive_gamertag_for_user | 사용자의 게이머 태그를 가져옵니다. |
| xboxlive_show_account_picker | 계정 선택기를 표시합니다. |
| xboxlive_get_user_count | 사용자 수를 가져옵니다. |
| xboxlive_get_user | 특정 사용자의 정보를 가져옵니다. |
| xboxlive_get_activating_user | 활성화 중인 사용자를 가져옵니다. |
| xboxlive_user_is_guest | 사용자가 게스트인지 확인합니다. |
| xboxlive_user_is_active | 사용자가 활성 상태인지 확인합니다. |
| xboxlive_user_is_remote | 사용자가 원격인지 확인합니다. |
| xboxlive_user_id_for_user | 특정 사용자의 ID를 가져옵니다. |
| xboxlive_sponsor_for_user | 사용자의 후원자를 가져옵니다. |
| xboxlive_set_rich_presence | 사용자의 상태를 설정합니다. |
| xboxlive_gamedisplayname_for_user | 사용자의 게임 표시 이름을 가져옵니다. |
| xboxlive_user_for_pad | 특정 패드에 대한 사용자를 가져옵니다. |
| xboxlive_pad_for_user | 특정 사용자에 대한 패드를 가져옵니다. |
| xboxlive_pad_count_for_user | 특정 사용자의 패드 수를 가져옵니다. |
| xboxlive_agegroup_for_user | 사용자의 연령 그룹을 가져옵니다. |
| xboxlive_gamerscore_for_user | 사용자의 게이머 점수를 가져옵니다. |
| xboxlive_show_profile_card_for_user | 사용자의 프로필 카드를 표시합니다. |
| xboxlive_reputation_for_user | 사용자의 평판을 가져옵니다. |
| xboxlive_sprite_add_from_gamerpicture | 게이머 사진에서 스프라이트를 추가합니다. |
| xboxlive_generate_player_session_id | 플레이어 세션 ID를 생성합니다. |
활용 예제
// 사용자가 로그인했는지 확인
if (xboxlive_user_is_signed_in()) {
// 로그인된 사용자 정보를 가져오기
var user_id = xboxlive_user_id_for_user();
var gamertag = xboxlive_gamertag_for_user();
show_message("사용자 ID: " + string(user_id) + ", 게이머 태그: " + gamertag);
}
// 활성화 중인 사용자 가져오기
var activating_user = xboxlive_get_activating_user();
if (activating_user != -1) {
// 활성화 중인 사용자에 대한 정보 처리
}
// 사용자 프로필 카드 표시
xboxlive_show_profile_card_for_user(user_id);
// 사용자의 게이머 점수 가져오기
var gamerscore = xboxlive_gamerscore_for_user();
show_message("사용자의 게이머 점수: " + string(gamerscore));
// 사용자의 연령 그룹 확인
var age_group = xboxlive_agegroup_for_user();
if (age_group == "Teen") {
show_message("사용자는 10대입니다.");
}
// 사용자 상태 설정
xboxlive_set_rich_presence("게임 중입니다!");
// 사용자 평판 가져오기
var reputation = xboxlive_reputation_for_user();
show_message("사용자의 평판 점수: " + string(reputation));