XblMultiplayerActivitySetActivityAsync
로컬 사용자에 관한 멀티 플레이어 활동을 설정하거나 업데이트합니다.
구문
HRESULT XblMultiplayerActivitySetActivityAsync(
XblContextHandle xblContext,
const XblMultiplayerActivityInfo* activityInfo,
bool allowCrossPlatformJoin,
XAsyncBlock* async
)
매개 변수
xblContext _In_
형식: XblContextHandle
로컬 사용자용 Xbox Live 컨텍스트입니다.
activityInfo _In_
형식: XblMultiplayerActivityInfo*
활동에 대한 정보입니다.
maxPlayers 및 currentPlayers 필드는 선택 사항입니다. 0으로 설정하면 무시됩니다.
platform 필드의 값은 무시됩니다. XSAPI는 적절한 로컬 플랫폼에서 자동으로 활동을 설정합니다.
allowCrossPlatformJoin _In_
형식: bool
타이틀에서 지원하는 다른 플랫폼에서 활동을 조인할 수 있는 경우 True입니다.
async _In_
형식: XAsyncBlock*
이 작업에 대한 XAsyncBlock입니다.
반환 값
형식: HRESULT
이 API 작업에 대한 HRESULT 반환 코드입니다.
설명
타이틀이 시작되거나 멀티 플레이어 환경에 참여할 때 활동을 만들어야 합니다. 이렇게 하면 플레이어의 타이틀에 있는 셸 및 다른 플레이어가 플레이어의 활동을 볼 수 있습니다. 타이틀에서 다른 플레이어가 진행 중인 게임에 참가하도록 할 수 있습니다. 플레이어에서 타이틀에 대한 활동에 참여하고 싶어 하지만 실행 되고 있지 않다면 바로 활성화되고 연결 문자열이 전달됩니다.
이 기능 사용 방법을 확인하려면 멀티 플레이어 활동 코드 예시의 활동 섹션에서 "활동 설정"을 참조하세요.
REST 호출
PUT /titles/{titleId}/users/{xuid}/activites를 호출합니다.
요구 사항
헤더: multiplayer_activity_c.h
도서관: Microsoft.Xbox.Services.14x.GDK.C.lib