Xbox Live 통계 사용자 추가 함수

이 문서는 Xbox Live 통계 관리자를 사용하여 사용자 ID 포인터를 추가하는 xboxlive_stats_add_user 함수에 대해 설명합니다. 이 함수는 다른 통계 함수들을 사용하기 전에 호출해야 하며, 게임을 Xbox Live 서버와 자동으로 동기화하고 최신 값을 가져오는 데 필요합니다.

함수 설명

  • 함수명: xboxlive_stats_add_user
  • 목적: 주어진 사용자 ID 포인터를 통계 관리자에 추가
  • 반환값:
  • -1: 오류 발생 또는 사용자 ID가 유효하지 않음
  • 그 외의 값: 함수가 성공적으로 호출됨

콜백 및 이벤트

이 함수는 System Asynchronous Event를 트리거하는 콜백을 생성합니다. 이 이벤트는 특별한 DS 맵 async_load를 포함하며, 다음 키를 파싱해야 합니다:

설명
"id" 상수 achievement_stat_event를 포함
"eventname" 문자열 "LocalUserAdded"를 포함
"userid" 요청과 관련된 사용자 ID
"error" 성공 시 0, 오류 발생 시 다른 값
"errormessage" 오류 메시지 문자열 (있을 경우)

문법

xboxlive_stats_add_user(user_id);

인수 설명

인수 유형 설명
user_id 포인터 추가할 사용자 ID

예제 코드

다음 코드는 사용 가능한 사용자 계정의 수를 가져온 후, 각 계정 ID를 배열에 할당하고 통계 관리자에 사용자를 등록합니다.

for(var i = 0; i < xboxlive_get_user_count(); ++i){
    user_id[i] = xboxlive_get_user(i);
    xboxlive_stats_add_user(user_id[i]);
}

이 코드는 xboxlive_get_user_count() 함수를 사용하여 사용자 계정의 수를 확인하고, 각 사용자 ID를 배열에 저장한 후 xboxlive_stats_add_user 함수를 호출하여 통계 관리자에 등록합니다.