특정 타이틀을 플레이하는 사용자의 활동을 설정하거나 업데이트합니다.
이 API를 사용하면 게임 클라이언트 또는 서버가 특정 타이틀을 플레이하는 사용자에 대한 멀티 플레이어 활동을 설정/업데이트할 수 있습니다. 사용자가 멀티 플레이어 활동에서 활성화되는 즉시 활동을 설정해야 합니다. Xbox Live 사용자는 다른 사용자(일반적으로 친구)의 활동 변경 내용을 구독할 수 있으며 이러한 업데이트는 RTA를 통해 Xbox 클라이언트에 푸시됩니다.
PUT /titles/{titleId}/users/{xuid}/activities
URI 매개 변수
매개 변수
그런 다음
필수
유형
설명
titleId
path
TRUE
정수
요청이 전송되는 게임의 titleId입니다.
xuid
path
TRUE
문자열
현재 요청에서 참조되는 사용자의 XUID입니다. XUID는 밑이 10인 정수로 표시됩니다.
요청 헤더
이름
필수
유형
설명
Authorization
TRUE
정수
호출자는 XBL 3.0 인증 형식으로 XToken을 제공해야 합니다. 예를 들어 권한 부여: XBL3.0 x=2553948354698;<암호화된 토큰>)
콘텐츠 종류
TRUE
문자열
ContentType을 application/json으로 설정해야 합니다.
요청 본문
이름
필수
유형
설명
connectionString
TRUE
문자열
연결 문자열은 게임에 참여하기 위해 연결하는 클라이언트에 전달되는 개체입니다. 연결 문자열에는 일반적으로 참여하는 사용자가 연결할 수 있도록 하는 서버 IP와 같은 정보가 포함됩니다. 연결 문자열의 길이는 512자로 제한됩니다.
joinRestriction
TRUE
JoinRestriction
현재 플레이어에 참가할 수 있는 사용자를 활성화하는 설정입니다.
sequenceNumber
TRUE
문자열
이것은 클라이언트가 각 요청에 대해 전달해야 하는 단조 증가 숫자(ulong)의 문자열 표현입니다. 활동에 대한 업데이트의 순서를 보장하는 데 사용됩니다. sequenceNumber의 좋은 예는 증가하는 것이 보장되기 때문에 클라이언트의 유닉스 시간이 될 수 있습니다. 0보다 커야 하며 최대 ulong보다 클 수 없습니다.
이것은 클라이언트가 각 요청에 대해 전달해야 하는 단조 증가 숫자(ulong)의 문자열 표현입니다. 활동에 대한 업데이트의 순서를 보장하는 데 사용됩니다. sequenceNumber의 좋은 예는 증가하는 것이 보장되기 때문에 클라이언트의 유닉스 시간이 될 수 있습니다. 0보다 커야 하며 최대 ulong보다 클 수 없습니다.