Xbox Live 통계 삭제 함수 설명
xboxlive_stats_delete_stat
함수는 주어진 사용자 ID에 대한 통계를 삭제하는 데 사용됩니다. 이 함수는 xboxlive_get_user()
와 같은 함수에서 반환된 사용자 ID와 삭제할 통계 문자열을 인수로 받습니다. 이 함수를 호출하면 해당 통계 값이 지워지고 통계 관리자에서 제거되어 더 이상 xboxlive_stats_get_stat_names()
또는 xboxlive_stats_get_stat()
함수에 의해 반환되지 않습니다.
함수 문법
xboxlive_stats_delete_stat(user_id, stat);
인수 설명
인수 이름 | 타입 | 설명 |
---|---|---|
user_id | 사용자 ID 포인터 | 통계를 삭제할 사용자 ID |
stat | 문자열 | 삭제할 통계 |
반환 값
- 오류가 발생하거나 사용자 ID가 유효하지 않은 경우: -1
- 함수가 성공적으로 호출된 경우: 다른 값
활용 예제
아래 코드는 연결된 사용자들을 반복하면서 각 사용자에 대해 지정된 통계를 삭제하는 예제입니다.
for(var i = 0; i < xboxlive_get_user_count(); i++;){
user_id[i] = xboxlive_get_user(i);
xboxlive_stats_delete_stat(user_id[i], "HighScore");
}
추가 활용 예제
- 특정 통계를 삭제하기 전에 해당 통계가 존재하는지 확인하는 코드:
gml var user_id = xboxlive_get_user(0); if (xboxlive_stats_get_stat(user_id, "HighScore") != undefined) { xboxlive_stats_delete_stat(user_id, "HighScore"); }
- 모든 사용자에 대해 여러 통계를 삭제하는 코드:
gml var stats_to_delete = ["HighScore", "TotalGames"]; for(var i = 0; i < xboxlive_get_user_count(); i++;){ user_id[i] = xboxlive_get_user(i); for(var j = 0; j < array_length(stats_to_delete); j++){ xboxlive_stats_delete_stat(user_id[i], stats_to_delete[j]); } }
- 삭제 후 통계 목록을 출력하는 코드:
gml var user_id = xboxlive_get_user(0); xboxlive_stats_delete_stat(user_id, "HighScore"); var stat_names = xboxlive_stats_get_stat_names(user_id); show_message("현재 통계: " + string(stat_names));