Product Sample 활용하기
- ZEPETO 제품 샘플
- ZEPETO.제품 API 참조
다음은 ZEPETO 제품의 샘플 구현입니다.
ZEPETO 제품 시스템을 이해하기 위해 샘플 구현을 이해하는 가이드를 따르기를 권장합니다.
샘플에는 통화 시스템, 인벤토리 시스템, 아이템 획득, 구매 및 UI 리소스의 예가 포함되어 있습니다.
❗️ 주의
- ZEPETO 월드를 만들 때 제공된 UI 리소스와 스크립트를 자유롭게 사용하세요.
- 그러나 ZEPETO 월드 외의 공개된 샘플 리소스를 사용하는 것은 금지되어 있습니다.
- 샘플에서 사용된 것과 동일한 이름으로 통화 및 제품을 등록해 주세요. (통화 ID와 제품 ID가 다르면 샘플과 연결할 수 없습니다.)
- 통화
ID | 통화 이름 |
|---|---|
별 | 별 |
에너지 | 에너지 |
- 항목 제품
ID | 이름 | 판매 통화 | 가격 | 유형 |
|---|---|---|---|---|
note1 | note1 | 별 | 10 | 비소모품 |
potion4 | potion4 | 에너지 | 4 | 소모품 |
potion3 | potion3 | 에너지 | 3 | 소모품 |
potion2 | potion2 | 에너지 | 2 | 소모품 |
potion1 | potion1 | 에너지 | 1 | 소모품 |
- 통화 패키지 제품
ID | 이름 | 판매 통화 | 가격 | 패키지 구성 |
|---|---|---|---|---|
energy4 | energy4 | ZEPETO ZEM | 4 | energy, 40 |
energy3 | energy3 | ZEPETO ZEM | 3 | energy, 30 |
energy2 | energy2 | ZEPETO ZEM | 2 | energy, 20 |
energy1 | energy1 | ZEPETO ZEM | 1 | energy, 10 |
- 아이템 패키지 제품
ID | 이름 | 판매 통화 | 가격 | 패키지 구성(항목) |
|---|---|---|---|---|
potion_package | potion_package | ZEPETO ZEM | 3 | potion4, 3 |
2) Assets/ProductSystem/Prefab에 있는 제품 캔버스를 장면에 가져옵니다.
3) 프로젝트에서 Project Setting > ZEPETO Service를 열어 월드가 제대로 연결되어 있는지 확인하세요.
4) Unity 메뉴 바 > ZEPETO > Product > Settings를 실행하세요.
- 통화 및 제품 목록이 잘 표시되면 링크가 성공적으로 연결됩니다.
- Assets>Product>Resources 폴더에 있는 아이콘 이미지가 설정되어 있는지 확인할 수 있습니다.
- 원하는 이미지를 사용하여 제품의 아이콘 사진을 등록할 수 있습니다.
❗️ 주의
- 제품을 제대로 볼 수 없는 경우, 다음 사항을 확인해 주세요.
- Unity Editor에 로그인한 계정 정보가 World id 생성자의 정보와 동일한지 확인해 주세요.
- Project Settings > ZEPETO Service에서 연결된 world ID 정보가 올바른지 확인해 주세요.
- 샘플에서 사용된 동일한 id 통화 및 제품이 등록되었는지 확인해 주세요.
5) 멀티 서버를 켜고 Play 버튼을 눌러 샘플을 실행해 주세요.
◦ 에너지 얻기 : 버튼을 클릭하면 에너지 제품 하나를 얻습니다.
◦ 에너지 사용 : 버튼을 클릭하면 에너지 아이템 하나를 차감할 수 있습니다.
◦ EXP 증가 : 버튼을 클릭하여 경험치를 10 얻습니다. 경험치를 얻고 레벨이 올라가면 5 스타 통화를 얻습니다.
◦ 랜덤 아이템 획득 : 버튼을 클릭하여 네 가지 포션 아이템 중 하나를 무작위로 인벤토리에 추가합니다.
◦ 즉시 구매 : 버튼을 클릭하면 에너지 아이템 하나를 차감하고 포션 1을 구매할 수 있습니다. 구매 창이 나타나지 않으며, 구매한 아이템은 즉시 인벤토리에 들어갑니다.
◦ UI를 통한 구매 : 버튼을 클릭하면 구매 창이 나타납니다. 구매 창에서 10 스타 통화를 차감하여 노트 1을 구매할 수 있습니다.
◦ 아이템 패키지 구매 : 버튼을 클릭하면 구매 창이 나타납니다. 구매 창에서 ZEPETO ZEM을 차감하여 포션 패키지 제품을 구매할 수 있습니다.
- 가방 아이콘: 버튼을 클릭하면 인벤토리 창이 표시됩니다. 보유한 아이템 목록을 확인하고 선택하여 사용할 수 있습니다.
- 쇼핑 카트 아이콘: 버튼을 클릭하면 에너지 화폐 구매 창이 나타납니다. 구매 창에서 ZEPETO ZEM을 차감하여 화폐 패키지 제품을 구매할 수 있습니다.
- 멀티 서버가 켜져 있을 때, ZEPETO 제품 테스트는 샌드박스 서버에서 가능합니다.
- 편집기에서 변경한 내용은 ZEPETO 스튜디오에 반영되지 않습니다.
- 프리테스트 및 출시된 월드에 대한 변경 사항은 ZEPETO 스튜디오에 반영됩니다.
- 멀티 서버가 꺼지면 샌드박스 테스트 환경이 초기화됩니다.(ZEPETO 스튜디오 데이터로 초기화됩니다.)
- 소모품이 아닌 아이템 테스트
- 멀티 서버가 켜져 있으면, 구매한 후에는 다시 구매할 수 없습니다.
- 멀티 서버를 끄면 테스트 환경이 초기화되므로, 멀티 서버를 다시 켜면 구매할 수 있습니다.
- 월드 커버 이미지를 등록하지 않으면 제품 테스트를 제대로 수행할 수 없습니다. ZEPETO 스튜디오에서 월드 커버 이미지가 올바르게 등록되었는지 확인해 주세요.
샘플은 항목 사용 후 콘텐츠를 구현하지 않습니다. 그 부분은 월드의 제작자가 의도한 대로 직접 구현해야 합니다. UICommonBtn.ts의 스크립트를 참조하십시오.
제품을 사용할 때 제품 ID에 따라 콘텐츠 코드를 구현하는 것이 핵심입니다.
potion2를 사용할 때 구현하려면 다음과 같은 변경을 하십시오:
ZEPETO 제품을 사용하여 경제 시스템을 서버와 통신하려면 서버 스크립트와 클라이언트 스크립트를 별도로 구현해야 합니다.
스크립트 구현에 대해서는 ZEPETO 제품 샘플 및 ZEPETO 제품 API에 구현된 예제 스크립트를 참조하십시오.
