다음을 통해 공유

카탈로그 뷰(프라이빗 미리 보기)

  • 아티클

참고 항목

카탈로그 뷰는 현재 프라이빗 미리 보기로 제공됩니다. 이 기능에 액세스하려면 카탈로그 뷰 비공개 미리 보기에 액세스라는 제목과 함께 PlayFab 타이틀 ID로 PFEconomyPreviews@microsoft.com에 전자 메일을 보내면 해당 환경에서 기능을 사용할 수 있습니다.

게임은 부팅 중에 아이템을 로드하여 원활한 플레이어 경험을 보장합니다. 주 메뉴 그래픽, 캐릭터 모델, 환경 텍스처와 같은 필수 자산을 미리 로드하면 지연 시간을 최소화하고 플레이어가 게임 콘텐츠에 더 빠르게 액세스할 수 있습니다. 그러나 자산의 크기와 복잡성, 네트워크 지연 시간, 자산 압축 및 압축 해제 등 다양한 요인으로 인해 게임 부팅 시 아이템을 로딩하는 데 시간이 오래 걸릴 수 있습니다. 이 문제를 해결하기 위해 PlayFab Economy V2에서는 카탈로그 뷰를 도입합니다.

카탈로그 뷰는 CDN(콘텐츠 배달 네트워크)을 통해 액세스할 수 있는 쿼리 결과의 정기적으로 업데이트되는 스토리지 Blob입니다. 그런 다음 이러한 공개/비공개 뷰를 호출하여 게임을 채울 수 있습니다. 이 비동기 업데이트는 캐싱 메커니즘을 적용하여 성능을 향상시키므로 자주 검색 쿼리가 필요하지 않습니다. 이 방법은 전반적인 효율성을 향상시킬 뿐만 아니라 PlayFab에 대한 API 호출 수를 최소화하여 비용을 절감합니다.

용어 정의

  • 카탈로그 뷰: 검색 쿼리를 정의하는 메타데이터의 컬렉션입니다. 비동기 방식으로 검색 결과를 나타내는 Blob를 정기적으로 업데이트하는 데 사용됩니다.

  • 카탈로그 뷰 Blob: 검색 쿼리를 나타내는 카탈로그 뷰에 의해 생성되는 Blob입니다.

  • 공개 뷰: 공개 뷰는 보기의 기본 액세스 상태입니다. 이 유형의 보기는 CDN을 통해 액세스할 수 있는 공용 Blob을 생성합니다. 이 Blob에는 검색의 동작과 같이 모든 사용자에게 공개되는 정보가 포함되어 있습니다. 예를 들어 타이틀 전용 아이템이 제외되며 시작/종료 날짜 범위를 벗어난 아이템도 제외됩니다. 카탈로그 뷰는 제목 뷰 또는 공개 뷰일 수 있습니다.

  • 제목 뷰: 제목 뷰는 모든 아이템 메타데이터를 포함하므로 사용자가 아닌 타이틀에서 사용하기 위한 카탈로그 뷰입니다. 이 유형의 보기는 GETView API 호출을 통해 얻을 수 있는 SAS 토큰을 통해 CDN을 통해 액세스할 수 있는 프라이빗 Blob을 생성합니다. 카탈로그 뷰는 제목 뷰 또는 공개 뷰일 수 있습니다.

  • 새로 고침 지연: 뷰 Blob을 새로 고치기 전(업데이트) 최소 시간입니다. 미리 보기의 모든 뷰에는 하루의 새로 고침 지연이 있으며 이 지연은 뷰 Blob을 업데이트할 때만 적용된다는 점에 유의하세요. 뷰 Blob에 대한 초기 생성은 뷰가 처리되는 즉시 발생합니다.

개념

  • 포함된 카탈로그 아이템: 뷰에는 게시된 아이템만 포함될 수 있으며 초안 아이템에는 사용할 수 없습니다. 뷰 Blob에 포함된 아이템은 뷰의 액세스 상태(제목/공개) 및 제공된 검색 쿼리에 따라 결정됩니다.

  • 제한 사항:

    • 현재 최대 10개 카탈로그 뷰를 만들 수 있습니다.

    • 뷰 Blob은 최대 500mb까지만 사용할 수 있으며 최대 10,000개의 아이템만 포함할 수 있습니다.

    • 보기의 검색 쿼리 복잡성은 검색 자체가 제한되고 보기 생성/업데이트 시 적용되는 것과 동일한 방식으로 제한됩니다.

  • CDN 구성:

    • 뷰 Blob은 views.prod.catalog.playfab.com을 통해 제공됩니다.

    • CDN에는 30분 캐시가 있습니다. 즉, 뷰를 삭제해도 30분 동안 CDN에서 뷰 Blob에 계속 액세스할 수 있습니다.

  • Blob 지원 파일 확장자 보기:

    • Json (.json)

    • JsonLines (.jsonl)

    • GZippedJson (.gz.json)

    • GZippedJsonLines (.gz.jsonl)

  • 상태: 뷰 Blob이 비동기적으로 생성되면 마지막 뷰 Blob 생성의 상태가 뷰에 추가됩니다. 상태는 여기에 자세히 설명되어 있습니다.

    • 성공: 뷰 Blob이 오류 없이 생성되었습니다.

    • FileSizeExceeded: 이 오류는 뷰 Blob을 만들 때 발생하며, 이는 파일 크기 바이트 제한 또는 포함된 아이템 수 제한을 초과했음을 나타냅니다. 고객은 파일 크기가 500mb이고 아이템 수가 10,000을 초과하지 않는지 검토해야 합니다.

    • 오류: 뷰 Blob을 처리하는 동안 예기치 않은 오류가 발생했습니다. PlayFab 엔지니어에게 통보되어 조사를 진행합니다.

    • StoreDoesNotExist: 뷰는 삭제된 저장소를 지정합니다. 고객은 올바른 StoreID가 입력되었는지 검토해야 합니다.

    • TransientError: 필요한 서비스 중 하나와 통신하는 동안 일시적인 연결 오류가 발생했습니다. PlayFab 엔지니어에게 통보되어 조사를 진행합니다.

    • PartialSuccess: 뷰 Blob이 생성되었지만 잘못된 메타데이터로 인해 일부 아이템을 삭제해야 했습니다. 이러한 아이템이 필요한 경우 고객은 잘못된 메타데이터를 검토하고 수정해야 합니다.

    • 보류 중: 뷰가 새로 만들어지고 처리가 보류 중이므로 '마지막 뷰 Blob 생성 상태'가 없습니다. 고객측의 조치가 필요하지 않습니다.

게임 관리자에서 카탈로그 뷰 만들기 및 업데이트

필수 구성 요소

  1. 카탈로그 뷰는 현재 비공개 미리 보기로 제공됩니다. 카탈로그 뷰 비공개 미리 보기에 액세스라는 제목과 함께 PlayFab 타이틀 ID로 PFEconomyPreviews@microsoft.com에 전자 메일을 보내면 해당 환경에서 기능을 사용할 수 있습니다.
  2. PlayFab 포털에 로그인합니다.
  3. 타이틀로 이동합니다.

새 뷰 만들기

  1. Economy>카탈로그 뷰(V2) (미리 보기)>새 뷰뷰 개요 스크린샷 선택
  2. 원하는 파일 유형과 공개 또는 제목 뷰를 선택하여 정적 속성을 채우기
  3. 다음 보기 속성을 채웁니다. 모든 필드는 선택 사항이지만 일부 필드에 값을 제공하면 쿼리 범위를 좁혀 더 정확한 결과를 가져올 수 있습니다.
    • 식별 ID - 새 뷰의 이름입니다. 예: 상위 10개 아이템, 크리스마스 판매 아이템 등
    • 카운트 - 쿼리하려는 아이템의 개수를 나타냅니다. 예: 1000.
    • 언어 - 아이템의 언어 인코딩을 나타냅니다. 예: en-US, en-CAN 등
    • 선택 - 쿼리하려는 특정 속성을 나타냅니다. 예: 이름, 가격 등
    • 필터 - 카탈로그 아이템을 필터링합니다. 예: eq '검'을 입력하여 카탈로그 내의 모든 검을 필터링합니다.
    • Store ID - 쿼리하려는 카탈로그 내의 Store ID입니다. 뷰 생성 스크린샷
  4. 뷰가 성공적으로 만들어지면 다운로드 링크가 표시되어 원래 선택한 형식으로 뷰를 다운로드할 수 있습니다. 성공한 뷰

뷰 삭제

  1. 뷰를 삭제하려면 뷰 개요 페이지>로 이동하여 뷰>삭제뷰 삭제 선택