Bulk Importer and Exporter

통계 및 업적 관리를 지원하는 툴을 알아봅니다.

6 분 소요

대량 임포터 및 익스포터 툴(Bulk Importer/Exporter Tool) 로 제품의 통계업적개발자 포털(Developer Portal) 인터페이스 외부에서 관리할 수 있습니다. 이 툴에서는 CSV 형식 데이터를 포함하는 zip 아카이브를 사용하므로, 광범위한 기존 프로그램 또는 자체 툴을 사용하여 통계와 업적을 보고 편집할 수 있습니다.

대량 임포트 툴은 통계와 업적의 definitions 에만 영향을 미칩니다. 사용자의 진행상황을 어떤 방식으로도 추가, 삭제, 변경하지 않습니다. 통계나 업적 정의를 삭제 및 재생성해도 사용자의 통계 및 업적 진행상황은 그대로 보존됩니다.

이 툴은 개발자 포털(Developer Portal)게임 서비스(Games Services) > 업적(Achievements) 에 있습니다. 대량 임포트/익스포트(Bulk Import/Export) 버튼은 상단 근처의 플레이어 조회(Player Lookup) 버튼과 새로 생성(Create New) 버튼 사이에 있습니다.

익스포트(1단계)

익스포트 프로세스에서는 다운로드할 수 있는 zip 아카이브를 생성합니다. 이 아카이브에는 제품의 모든 기존 통계와 업적으로 구성된 .csv 파일과 .png 이미지가 포함되어 있습니다.

이러한 파일은 대부분의 스프레드시트 소프트웨어 애플리케이션에서 쉽게 임포트 및 익스포트할 수 있도록 표준 .csv 형식을 준수합니다. 익스포트하려는 이미지 파일은 표준 .png 형식이어야 합니다.

익스포트를 시작하려면 현재 업적 익스포트(Export Current Achievements) 를 클릭하면 됩니다. 자동으로 다운로드가 시작되고, 다운로드한 콘텐츠가 일반적으로 저장되는 경로에 .zip 폴더를 생성합니다.

다음(Next) 을 클릭해 익스포트를 건너뛸 수도 있습니다. 현재 업적의 백업이 없다면, 이 단계를 건너뛰는 것은 추천하지 않습니다.

임포트(2, 3단계)

임포트 프로세스에서는 익스포트 프로세스와 같은 파일 형식을 사용합니다. 임포트 .zip 파일에는 다음과 같은 파일이 필요합니다.

파일 이름콘텐츠
stats.csv각 통계를 정의하는 '이름과 유형' 쌍 목록
achievementDefinitions.csv업적 이름과 참조하는 통계 목록
achievementLocalizations.csv업적 현지화 로케일 키와 그 아이콘의 파일 이름
하나 이상의 .png 파일achievementDefinitions.csv에서 참조하는 아이콘

.zip 파일을 업로드할 개발자 포털에서 .zip 템플릿을 다운로드하거나(EOS 업적 ZIP 템플릿 다운로드(Download EOS Achievements Zip Template) 클릭) 여기를 클릭하면 임포트할 .zip 파일을 준비하는 데 도움이 됩니다. 어떤 방법을 사용하든, 콘텐츠가 잘 정리된 BulkTemplate.zip 폴더를 자동으로 다운로드합니다.

EOS 업적 대량 임포트 템플릿 샘플

임포트 프로세스를 시작하기 전에 CSV이미지 파일의 요구 사항을 검토하시기 바랍니다.

파일을 임포트할 준비가 됐으면, 대량 임포트 프로세스 2단계에서 업로드할 파일 선택(Choose File to Upload) 을 클릭합니다. 임포트 시 제품의 모든 기존 업적이 삭제되고 모든 통계가 제거된다는 경고를 읽었음을 확인합니다.

다음(Next) 을 클릭해서 임포트한 콘텐츠의 유효성 검사를 시작합니다. 검사가 완료되면 백엔드 서비스에서 기존 통계와 업적을 모두 삭제한 뒤 .zip 파일에 있는 통계와 업적으로 대체합니다. 이 작업에는 백엔드 서비스에서 새 업적이 사용하는 아이콘 캐싱도 포함됩니다.

임포트 창의 마지막 단계에서는 업적과 통계의 임포트에 성공했다는 내용이 나타납니다.

CSV 파일 형식 요구 사항

업로드하는 .csv 파일이 유효성 검사를 통과하도록 아래에 나열된 파일 유형별 데이터 형식을 사용하고 빈 행이 없도록 합니다. 모든 CSV 파일은 반드시 UTF-8 인코딩 파일이어야 합니다.

stats.csv 형식

stats.csv 파일에는 통계마다 두 개의 열, 즉 통계의 이름과 집계 유형이 있습니다. 집계 유형으로 지원되는 값은 SUM, MIN, MAX 또는 LATEST 입니다. 샘플 stats.csv 파일은 다음과 같습니다.

name,aggregationType
numTreesChopped,SUM
lastTreesChopped,LATEST
maxTreesChopped,MAX
minTreesChopped,MIN
numAxesUsed,SUM

자세한 정보는 통계 인터페이스를 참고하세요.

achievementDefinitions.csv 형식

achievementsDefinitions.csv 에서는 세 개의 열을 사용하여 각 업적과 업적을 잠금해제하기 위한 요구 사항을 정의합니다. 처음 두 열에는 업적의 내부 이름과 업적의 숨김 여부를 나타내는 부울 값이 있습니다.

세 번째 열은 선택사항입니다. 이 열이 비어 있으면 EOS SDK의 명시적 명령을 통해서만 업적의 잠금을 해제할 수 있습니다. 세 번째 열이 있으면 이는 통계 이름과 한계치 목록이며, 다음 Achievements.csv 샘플 파일에 표시된 대로 Stat1:Threshold1;Stat2:Threshold2;StatN:ThresholdN 양식을 사용합니다.

name,hidden,statThresholds
achvTutorial,FALSE,
achvLumberjack,FALSE,numTreesChopped:3
achvWoodsman,TRUE,numTreesChopped:100;numAxesUsed:5

자세한 정보는 업적 인터페이스를 참고하세요.

achievementLocalizations.csv 형식

업적에 관해 사용자에게 표시되는 모든 정보는 현지화할 수 있습니다.

achievementLocalizations.csv 는 시스템에서 여러 다른 로케일을 사용하는 사용자에게 각 업적을 설명하는 데 필요한 모든 데이터를 설정합니다. 여기에는 업적의 내부 이름과 로케일, 잠겨 있을 때의 제목과 설명, 잠기지 않았을 때의 제목과 설명, 부가 설명, 잠김 및 잠금해제된 아이콘이 순서대로 표시됩니다. 다음 achievementLocalizations.csv 샘플 파일에서는 동일한 업적 세트의 디폴트(두 번째 열이 비어 있음) 버전과 독일어(두 번째 열에 ‘de’ 가 표시됨) 버전을 표시합니다.

name,locale,lockedTitle,lockedDescription,unlockedTitle,unlockedDescription,flavorText,lockedIcon,unlockedIcon
achvTutorial,,Intro,Complete the Tutorial,Intro,Completed the Tutorial,Onwards!,locked.png,tutorial.png
achvTutorial,de,Einführung,Schließe die Einführung ab,Einführung,Die Einführung abgeschlossen,Weiter!,locked.png,tutorial.png
achvLumberjack,,Lumberjack,Chop 3 trees,Lumberjack,Chopped 3 trees,Timber!,locked.png,lumberjack.png
achvLumberjack,de,Holzfäller,Fälle drei Bäume,Holzfäller,Drei Bäume gefällt,Holz!,locked.png,lumberjack_de.png
achvWoodsman,,Woodsman,Roam the woods,Woodsman,Travelled the woods and chopped some trees,,lockedSecret.png,woodsman.png
achvWoodsman,de,Waldmensch,Durschtreife die Wälder,Waldmensch,Die Wälder bereist und Bäume gefällt,,lockedSecret.png,woodsman.png

.csv 파일의 로케일(두 번째) 열에 입력하는 텍스트는 반드시 아래의 태그 형식과 일치해야 합니다.

로케일태그
아랍어ar
덴마크어da
네덜란드어nl
영어(미국)en-US
영어(영국)en-GB
핀란드어fi
프랑스어fr
독일어de
이탈리아어it
일본어ja
한국어ko
노르웨이어no
폴란드어pl
포르투갈어(브라질)pt-BR
러시아어ru
중국어 간체자zh-Hans
스페인어(멕시코)es-MX
스페인어(스페인)es-ES
스웨덴어sv
태국어th
중국어 번체자zh-Hant
터키어tr

2021년 2월 23일에 영어(영국), 스웨덴어, 중국어 번체자, 중국어 간체자의 로케일 코드가 업데이트되었습니다. 이 날짜 이전에 만든 .zip 파일은 임포트하지 마세요. 새로운 로케일 코드에 맞게 파일을 업데이트하거나 데이터를 새로 익스포트하시기 바랍니다.

아이콘 요구 사항

achievementDefinitions.csv 에서 참조하는 아이콘은 임포트하는 현재 zip 아카이브에 포함되어 있어야 합니다. 신규 임포트와 동시에 기존 콘텐츠가 전부 삭제되기 때문입니다. 모든 아이콘은 .png 형식이어야 하고 아카이브의 루트 레벨에 있어야 합니다. .zip 파일에 하위 폴더가 있어서는 안 됩니다.

개발자 포털 오류를 방지하기 위해 아이콘 파일 이름은 다음 문자를 포함할 수 없습니다. \ { ^ } % ` ] > [ ~ < # | & $ @ = ; : + , ? 또는 공백 ' ‘

여러 업적이 같은 아이콘 파일을 참조할 때 아이콘을 공유하면 사용자의 중복 다운로드를 피할 수 있습니다. 숨겨진 업적의 ‘잠김’ 아이콘처럼 여러 업적이 같은 이미지를 사용할 때 이 기능을 사용하세요.