PFSegmentsGetPlayersInSegmentRequest - XBOX Game Development Documentation

PFSegmentsGetPlayersInSegmentRequest 데이터 모델입니다. 최초 요청에는 최소한 Segment ID가 포함되어야 합니다. 후속 요청에는 Segment ID와 Continuation Token이 모두 포함되어야 합니다. Continuation Token을 전송하지 않으면 새로운 플레이어 세그먼트 목록이 생성됩니다. Continuation Token이 전달될 때마다 Total Seconds to Live의 길이가 갱신됩니다. 요청 사이의 시간이 너무 많이 지나 후속 요청이 Total Seconds to Live를 지나면 오류가 반환되고 페이징이 종료됩니다. 이 API는 리소스를 많이 사용하므로 요청 볼륨이 많이 발생할 수 있는 시나리오에서는 사용하면 안 됩니다. 타이틀당 이 API에 대한 요청은 한 번에 하나만 이루어져야 합니다. 동시 요청은 APIConcurrentRequestLimitExceeded 오류로 거부될 수 있습니다.

구문

typedef struct PFSegmentsGetPlayersInSegmentRequest {  
    const char* continuationToken;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    bool const* getProfilesAsync;  
    uint32_t const* maxBatchSize;  
    uint32_t const* secondsToLive;  
    const char* segmentId;  
} PFSegmentsGetPlayersInSegmentRequest;  

멤버

continuationToken const char*
is null-terminated (선택 사항) 결과의 후속 페이지를 검색하는 경우의 Continuation Token입니다. customTags PFStringDictionaryEntry const*
may be nullptr (선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등). customTagsCount uint32_t customTags의 개수입니다. getProfilesAsync bool const*
may be nullptr (선택 사항) true로 설정된 경우 프로필이 비동기적으로 로드되며, 첫 번째 프로필 배치가 로드될 때까지 응답에는 continuation token과 대략적인 프로필 수가 포함됩니다. 네트워크 시간 초과를 피하는 데 도움이 되도록 이 매개 변수를 사용하세요. maxBatchSize uint32_t const*
may be nullptr (선택 사항) 최댓값은 10,000입니다. 값이 0이면 프로필을 로드하지 않고 이 세그먼트와 일치하는 프로필 수만 반환합니다. secondsToLive uint32_t const*
may be nullptr (선택 사항) continuation token을 활성 상태로 유지할 시간(초)입니다. 토큰이 만료되면 결과 페이징을 계속할 수 없습니다. 기본값은 300(5분)입니다. 최댓값은 5,400(90분)입니다. segmentId const char*
is null-terminated 이 세그먼트의 고유 식별자입니다.

요구 사항

헤더: PFSegmentsTypes.h

참고 항목

PFSegmentsTypes 멤버

​구문

​멤버

​요구 사항

​참고 항목

구문

멤버

요구 사항

참고 항목