구문
매개 변수
handle PFMultiplayerHandle
PFMultiplayer API 인스턴스의 핸들입니다.
entity PFEntityKey*
토큰과 연결할 PlayFab 엔터티 키입니다.
entityToken char*null로 끝남 TBD
반환 값
형식: HRESULT 로컬 사용자 생성에 성공한 경우S_OK이며 그렇지 않은 경우 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
이 메서드는 PlayFab 엔터티 키를entity로, PlayFab 엔터티 토큰을 token으로 받습니다. 라이브러리가 로비를 만들거나 업데이트하는 등 인증 또는 권한 부여가 필요한 엔터티를 대신하여 작업을 수행할 때, 라이브러리는 해당 작업에 사용할 엔터티와 연결된 토큰을 조회합니다. 이전에 엔터티에 대한 토큰이 설정되지 않은 경우 작업은 동기적으로 실패합니다. 비동기 작업 중에 PlayFab 서비스는 토큰이 유효한지, 만료되지 않았는지, 제공된 엔터티 ID와 연결되어 있는지, 작업을 수행할 권한이 있는지 확인합니다. 이러한 조건이 충족되지 않으면 작업은 실패합니다. PlayFab 엔터티 키와 엔터티 토큰은 PlayFab 로그인 작업의 출력에서 얻을 수 있으며 이 메서드에 입력으로 제공될 수 있습니다.
제공된
entity와 token은 PFMultiplayerInitialize()에 전달된 동일한 PlayFab Title ID를 사용하여 획득되어야 합니다. 멀티플레이어 라이브러리는
PFMultiplayerCreateAndJoinLobby와 같이 로컬 사용자의 인증 또는 권한 부여를 요구하는 후속 작업에 사용하기 위해 제공된 PlayFab 엔터티 토큰의 복사본을 만듭니다. 이 호출에 제공된 토큰이 만료되었거나 유효하지 않은 경우, 유효한 토큰이 필요한 작업은 실패합니다. 새롭고 유효한 토큰은 동일한 엔터티 키를 사용하여 이 메서드를 다시 호출하여 멀티플레이어 라이브러리에 제공될 수 있습니다. 호출자는 이 메서드에 제공된 엔터티 토큰의 만료를 모니터링할 책임이 있습니다. 토큰이 만료 시간에 가까워지거나 만료된 경우 PlayFab 로그인 작업을 수행하여 새 토큰을 획득하고 이 메서드를 다시 호출하여 멀티플레이어 라이브러리에 제공해야 합니다. 이전에 제공된 토큰이 유효 기간의 절반을 지날 때 새 토큰을 획득하는 것이 좋습니다. 저전력 상태에 진입하거나 애플리케이션 실행을 오랫동안 일시 중지시켜 토큰이 만료되기 전에 새로 고쳐지지 않는 플랫폼에서는 실행이 재개되면 토큰의 만료 여부를 확인해야 합니다.
이러한 값에 대해 동기 유효성 검사가 수행되지 않습니다.
요구 사항
헤더: PFMultiplayer.h함께 보기
PFMultiplayer membersPFMultiplayerInitialize