Skip to main content

XblMultiplayerActivitySetActivityAsync

로컬 사용자에 대한 멀티플레이어 활동을 설정하거나 업데이트합니다.

Syntax

Parameters

xblContext   _In_
Type: XblContextHandle
로컬 사용자의 XBOX Live 컨텍스트입니다. activityInfo   _In_
Type: XblMultiplayerActivityInfo*
활동에 대한 정보입니다. maxPlayerscurrentPlayers 필드는 선택 사항이며 0으로 설정된 경우 무시됩니다. platform 필드의 값은 무시됩니다. XSAPI가 적절한 로컬 플랫폼에서 활동을 자동으로 설정합니다. allowCrossPlatformJoin   _In_
Type: bool
활동이 타이틀에서 지원하는 다른 플랫폼에서도 참여 가능해야 하는 경우 True입니다. async   _In_
Type: XAsyncBlock*
이 작업에 대한 XAsyncBlock입니다.

Return value

Type: HRESULT 이 API 작업의 HRESULT 반환 코드입니다.

Remarks

타이틀이 멀티플레이어 경험을 시작하거나 참여할 때 활동을 만들어야 합니다. 그러면 셸과 타이틀의 다른 플레이어 모두 플레이어의 활동을 볼 수 있습니다. 타이틀은 다른 플레이어가 진행 중인 게임에 참여하도록 허용할 수 있습니다. 플레이어가 타이틀의 활동에 참여하려고 하는데 타이틀이 실행 중이 아니면 타이틀이 활성화되고 연결 문자열이 전달됩니다.

이 함수가 어떻게 사용되는지 보려면 멀티플레이어 활동 예제 코드Activities 섹션에서 “Setting an activity”를 참조하세요.

REST Call

PUT /titles//users//activites를 호출합니다.

Requirements

Header: multiplayer_activity_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

See also

multiplayer_activity_c
마지막 수정일 2026년 8월 24일