선물하기 API
11 분
ZEPETO 월드 내에서 다른 사용자에게 의류 아이템을 선물하기 위해 선물하기 API를 사용할 수 있습니다.
단, API 사용 시 보내는 사람의 재화는 차감됩니다.
설치
Window → 패키지 관리자 → ZEPETO.World 패키지를 먼저 1.21.14 버전 이상으로 설치하십시오.
그 후, 1.0.7 버전 이상의 ‘ZEPETO.Module’ 패키지를 설치하십시오.
ZEPETO 앱이 3.46.000 버전 이상으로 실행되고 있는지 확인하십시오.

기프트 API
기프트 API를 사용하려면 아래의 import 문을 추가하십시오.
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
Gifting API에 관심이 있으시면 문서를 참조하세요:
📘 다음 가이드를 참조하세요. [ZEPETO.Module.Shop API]
- Unity 에디터에서 성공 및 실패 사례를 모두 테스트할 수 있습니다. 기부가 성공하더라도 통화가 차감되지 않으며, 선물은 수신자에게 전달되지 않습니다.
- QR 코드나 테스트 링크를 통한 모바일 테스트 중 성공적인 거래는 실제 통화 차감으로 이어지며, 선물이 수신자에게 전달됩니다.
사용 예시
- 캔버스에 선물 보내기 버튼을 추가해 주세요.
- 아래와 같이 예제 코드를 작성해 주세요.
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
import { Button } from 'UnityEngine.UI';
import { ErrorCode } from 'ZEPETO.Module';
export default class SendGift extends ZepetoScriptBehaviour {
public itemId : string;
public targetUserId : string;
public sendGiftButton : Button;
Start() {
this.sendGiftButton.onClick.AddListener(()=>{
ShopService.ShowGiftPopup(
this.itemId,
this.targetUserId,
GiftBackgroundType.Type01,
"안녕하세요, 이건 당신을 위한 것입니다!",
(response: ItemGiftResponse) => { // onComplete callback
console.log(`선물이 성공적으로 전송되었습니다! ZEPETO 코인 잔액 ${response.coin}, ZEM 잔액 ${response.zem}`);
},
(error: ErrorCode) => { // onFailure callback
console.error("선물 전송 오류:", error);
}
);
});
}
}
- 스크립트를 작성한 후, 인스펙터에서 버튼을 연결하고 선물을 받을 사람의 userID와 itemID를 입력하세요.
📘 Zepeto Player의 UserId를 얻는 방법에 대한 다음 가이드를 참조하십시오. [ZEPETO Player]
- 성공 또는 실패 사례를 테스트하려면 QR 코드를 생성한 다음 모바일 장치에서 테스트하십시오.
- 그러나 발신자의 상품이 차감된다는 점에 유의하십시오.
선물이 성공적으로 전송되었을 때
- 버튼을 클릭하면 선물을 보내기 위한 팝업 UI가 나타납니다.

- 선물이 성공적으로 전송되면 성공을 나타내는 Toast UI가 나타나고, 예제 스크립트가 로그를 생성합니다.


- 추가적으로, targetUser를 위한 선물이 도착했습니다.

선물 발송 실패 시
- 해당 사례가 ErrorCode에 해당하면, Toast UI에 오류 메시지가 표시되며, 예제 스크립트는 해당 오류 코드를 출력합니다.

