메서드(1/2)
엔터티를 대신해 라이브러리 작업을 수행할 때 인증에 사용할 토큰을 설정합니다. 이전에 엔터티에 토큰이 설정되어 있었다면, 이전 토큰을 대체합니다.설명(1/2)
이 메서드는 PlayFab 로그인 메서드가 반환한 PlayFabAuthenticationContextauthContext를 사용합니다. 라이브러리가 인증 또는 권한 부여가 필요한 엔터티를 대신하여 로비 만들기나 업데이트와 같은 작업을 수행할 때 라이브러리는 해당 작업에 사용할 엔터티와 연결된 토큰을 찾습니다. 이전에 엔터티에 토큰이 설정되지 않은 경우 작업은 동기적으로 실패합니다. 비동기 작업 중에 PlayFab 서비스는 토큰이 유효하고, 만료되지 않았으며, 제공된 엔터티 ID와 연결되어 있고, 작업을 수행할 권한이 있는지 확인합니다. 이러한 조건이 충족되지 않으면 작업이 실패합니다.
PlayFab 엔터티 키와 엔터티 토큰은 PlayFab 로그인 작업의 출력에서 얻은 다음 이 메서드에 대한 입력으로 제공할 수 있습니다.
제공된 authContext는 Initialize에 전달된 동일한 PlayFab 타이틀 ID를 사용하여 획득해야 합니다.
Multiplayer 라이브러리는 CreateAndJoinLobby와 같이 로컬 사용자의 인증 또는 권한 부여가 필요한 후속 작업에 사용하기 위해 제공된 PlayFab 엔터티 토큰의 사본을 만듭니다. 이 호출에 제공된 토큰이 만료되었거나 유효하지 않은 경우, 유효한 토큰이 필요한 작업은 실패합니다. 동일한 엔터티 키를 사용하여 이 메서드를 다시 호출하여 Multiplayer 라이브러리에 유효한 새 토큰을 제공할 수 있습니다.
호출자는 이 메서드에 제공된 엔터티 토큰의 만료를 모니터링할 책임이 있습니다. 토큰이 만료 시간에 가까워지거나 만료 시간이 지난 경우 PlayFab 로그인 작업을 수행하여 새 토큰을 얻고 이 메서드를 다시 호출하여 Multiplayer 라이브러리에 제공해야 합니다. 이전에 제공된 토큰의 유효 기간이 절반 정도 지났을 때 새 토큰을 획득하는 것이 좋습니다. 저전력 상태에 진입할 수 있거나 애플리케이션 실행이 오랫동안 일시 중지될 수 있는 플랫폼에서 토큰이 만료되기 전에 새로 고치지 못하게 되는 경우, 실행이 재개된 후 토큰 만료 여부를 확인해야 합니다.
메서드(2/2)
엔터티를 대신해 라이브러리 작업을 수행할 때 인증에 사용할 토큰을 설정합니다. 이전에 엔터티에 토큰이 설정되어 있었다면, 이전 토큰을 대체합니다.설명(2/2)
이 메서드는 localMember로 PlayFab 엔터티 키를, entityToken으로 PlayFab 엔터티 토큰을 사용합니다. 라이브러리가 인증 또는 권한 부여가 필요한 엔터티를 대신하여 로비 만들기나 업데이트와 같은 작업을 수행할 때 라이브러리는 해당 작업에 사용할 엔터티와 연결된 토큰을 찾습니다. 이전에 엔터티에 토큰이 설정되지 않은 경우 작업은 동기적으로 실패합니다. 비동기 작업 중에 PlayFab 서비스는 토큰이 유효하고, 만료되지 않았으며, 제공된 엔터티 ID와 연결되어 있고, 작업을 수행할 권한이 있는지 확인합니다. 이러한 조건이 충족되지 않으면 작업이 실패합니다. PlayFab 엔터티 키와 엔터티 토큰은 PlayFab 로그인 작업의 출력에서 얻은 다음 이 메서드에 대한 입력으로 제공할 수 있습니다. 제공된 localMember와 entityToken은Initialize에 전달된 동일한 PlayFab 타이틀 ID를 사용하여 획득해야 합니다.
Multiplayer 라이브러리는 CreateAndJoinLobby와 같이 로컬 사용자의 인증 또는 권한 부여가 필요한 후속 작업에 사용하기 위해 제공된 PlayFab 엔터티 토큰의 사본을 만듭니다. 이 호출에 제공된 토큰이 만료되었거나 유효하지 않은 경우, 유효한 토큰이 필요한 작업은 실패합니다. 동일한 엔터티 키를 사용하여 이 메서드를 다시 호출하여 Multiplayer 라이브러리에 유효한 새 토큰을 제공할 수 있습니다.
호출자는 이 메서드에 제공된 엔터티 토큰의 만료를 모니터링할 책임이 있습니다. 토큰이 만료 시간에 가까워지거나 만료 시간이 지난 경우 PlayFab 로그인 작업을 수행하여 새 토큰을 얻고 이 메서드를 다시 호출하여 Multiplayer 라이브러리에 제공해야 합니다. 이전에 제공된 토큰의 유효 기간이 절반 정도 지났을 때 새 토큰을 획득하는 것이 좋습니다. 저전력 상태에 진입할 수 있거나 애플리케이션 실행이 오랫동안 일시 중지될 수 있는 플랫폼에서 토큰이 만료되기 전에 새로 고치지 못하게 되는 경우, 실행이 재개된 후 토큰 만료 여부를 확인해야 합니다.
함께 보기
- method Initialize
- class PFEntityKey
- class PlayFabMultiplayer
- namespace PlayFab.Multiplayer