구성 원본 및 우선순위
설정은 세 가지 원본에서 가져오며, 나중 원본이 앞선 원본을 재정의합니다.- 실행 파일에 컴파일된 기본 제공 기본값. 설정을 참조하세요.
- 환경 변수. 환경 변수를 참조하세요.
- 명령줄 옵션. CLI 옵션 재정의를 참조하세요.
설정
AzureAd:*는 사용자 로그인을 구성합니다. 인증을 참조하세요.PlayFab:StudioBaseUrl은playfab service-principal이 호출하는 API와 같은 스튜디오 API(/Studio/*)의 PlayFab 엔드포인트입니다.XboxPartner:TimeoutSeconds는game과 같은 명령의 요청 시간 제한(초)이며, 양수여야 합니다.XblPCSandbox:Path는pc sandbox명령이 실행하는XblPCSandbox.exe입니다. 설정되지 않은 경우 CLI는 자체 디렉터리를 찾은 다음PATH에서 찾습니다.AuditLog:Enabled는 감사 로그를 켭니다.Telemetry:*는 원격 분석에 설명되어 있습니다.
PlayFab:BaseUrlTemplate, PlayFab:StudioBaseUrl 또는 XboxPartner:BaseUrl이 기본 제공
기본값이 아니면, 해당 엔드포인트로 토큰을 보내는 모든 명령이 먼저 stderr에 경고를
작성합니다.
환경 변수
설정의 변수는XBOX_와 해당 키로 구성되며, 각 :는 __(밑줄 두 개)로 바뀝니다.
따라서 Telemetry:Enabled는 XBOX_TELEMETRY__ENABLED입니다. 이름은 대문자로 작성하세요. 변수는
해당 변수를 설정한 셸과 해당 셸이 시작하는 모든 명령에 적용됩니다.
XBOX_AUTHENTICATION__ 설정은 환경 변수에서만 읽으며, 기본 제공 기본값이나 옵션에서는
읽지 않습니다.
자동화(서비스 주체) 인증을 참조하세요.
CLI 옵션 재정의
옵션은 명령 하나에 대해 다른 모든 원본을 재정의합니다.
다른 전역 옵션은 명령을 참조하세요.
원격 분석 구성
공식 릴리스는 사용자가 끄지 않는 한 제한된 익명 원격 분석을 수집합니다. 명령 하나에 대해 끄려면 다음을 실행합니다.appsettings.json을 읽던 릴리스에서 업그레이드
이전 릴리스는 실행 파일 옆에 있는appsettings.json을 읽었습니다. 이 파일에서 값을 변경했다면
대신 해당 XBOX_ 변수를 설정하세요. 예를 들어 "AzureAd": { "ClientId": "..." }는
XBOX_AZUREAD__CLIENTID가 됩니다. 전환을 마칠 때까지 다음 메시지가 표시될 수 있습니다.
-
--config-env가 다음 오류와 함께 실패합니다. 이 옵션을 제거하고 대신XBOX_변수를 설정하세요. -
appsettings*.json파일이 실행 파일 옆에 있는 동안 명령이 stderr에 다음 메모를 작성합니다. 파일을 삭제하세요. -
이전 오류 메시지에 따라
XBOX_PLAYFAB__REQUESTHEADERS__0__VALUE를 설정한 경우 PlayFab 명령이 해당 변수 이름을 명시하는 오류와 함께 실패합니다. 변수를 제거하세요.
