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