PFSegmentsServerGetPlayersInSegmentAsync - XBOX Game Development Documentation

지정된 세그먼트의 모든 플레이어를 페이징하여 조회할 수 있게 합니다. 이 API는 생성 시점에 세그먼트 정의와 일치하는 모든 플레이어 프로필의 스냅샷을 만들며, Total Seconds to Live 동안 유지되고 이후 Continuation Token을 사용할 때마다 수명이 갱신됩니다. 페이징 도중 변경된 프로필은 결과에 반영되지 않습니다. AB Test 세그먼트는 현재 이 작업에서 지원되지 않습니다. 참고: 이 API는 1분당 30회 호출로 제한됩니다. 이 임계값을 초과하면 오류가 반환됩니다.

구문

HRESULT PFSegmentsServerGetPlayersInSegmentAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFSegmentsGetPlayersInSegmentRequest* request,  
    XAsyncBlock* async  
)  

매개 변수

titleEntityHandle PFEntityHandle PFAuthenticationGetEntityWithSecretKeyAsync를 사용하여 얻은 타이틀 Entity에 대한 PFEntityHandle입니다. request PFSegmentsGetPlayersInSegmentRequest* 값이 채워진 요청 객체입니다. async XAsyncBlock*
Inout 비동기 작업을 위한 XAsyncBlock입니다.

반환 값

Type: HRESULT 이 API 작업의 결과 코드입니다.

설명

이 API는 Win32, Linux, macOS에서 사용할 수 있습니다. 최초 요청에는 최소한 Segment ID가 포함되어야 합니다. 후속 요청에는 Segment ID와 Continuation Token이 모두 포함되어야 합니다. Continuation Token을 전송하지 않으면 새로운 플레이어 세그먼트 목록이 생성됩니다. Continuation Token이 전달될 때마다 Total Seconds to Live의 길이가 갱신됩니다. 요청 사이의 시간이 너무 많이 지나 후속 요청이 Total Seconds to Live를 지나면 오류가 반환되고 페이징이 종료됩니다. 이 API는 리소스를 많이 사용하므로 요청 볼륨이 많이 발생할 수 있는 시나리오에서는 사용하면 안 됩니다. 타이틀당 이 API에 대한 요청은 한 번에 하나만 이루어져야 합니다. 동시 요청은 APIConcurrentRequestLimitExceeded 오류로 거부될 수 있습니다. ServerGetAllSegmentsAsync도 함께 참조하세요. 비동기 작업이 완료되면 PFSegmentsServerGetPlayersInSegmentGetResultSize 및 PFSegmentsServerGetPlayersInSegmentGetResult를 호출하여 결과를 가져옵니다.

요구 사항

헤더: PFSegments.h

참고 항목

PFSegments 멤버

​구문

​매개 변수

​반환 값

​설명

​요구 사항

​참고 항목

구문

매개 변수

반환 값

설명

요구 사항

참고 항목