ZEPETO.Product

형식 설명 baseresponse /#baseresponse 응답 클래스의 기본 클래스입니다 baserequest /#baserequest 응답 데이터로 제네릭 타입 tresponse 를 받는 baserequest 클래스입니다 productlistresponse /#productlistresponse productlistresponse 클래스는 api 호출 결과와 가져온 상품 정보 목록을 제공합니다 productbaseresponse /#productbaseresponse 상품 관련 응답 클래스의 기본 클래스입니다 productresponse /#productresponse productresponse 클래스는 api 호출 결과와 가져온 상품 정보를 제공합니다 purchaseresponse /#purchaseresponse productresponse 클래스는 api 호출 결과와 구매 정보를 제공합니다 currencylistresponse /#currencylistresponse currencylistresponse 클래스는 api 호출 결과와 재화 정보 목록을 제공합니다 currencyresponse /#currencyresponse currencyresponse 클래스는 api 호출 결과와 재화 정보를 제공합니다 productrecord /#productrecord 상품 정보입니다 currencyrecord /#currencyrecord 재화 정보입니다 itempackageunitrecord /#itempackageunitrecord 아이템 상품 패키지에 포함된 개별 상품의 세부 정보입니다 currencypackageunitrecord /#currencypackageunitrecord 재화 상품 패키지에 포함된 개별 재화의 세부 정보입니다 producttype /#producttype 상품 유형을 나타내는 열거형입니다 purchasetype /#purchasetype 상품 구매 유형을 나타내는 열거형입니다 productstatus /#productstatus 상품 상태를 나타내는 열거형입니다 currencytype /#currencytype 재화 유형을 나타내는 열거형입니다 productservice /#productservice productservice 는 world 내 상품과 관련된 작업을 관리합니다 이 서비스를 통해 플레이어는 world 내 상품 정보에 접근하고 구매를 진행할 수 있습니다 productpurchasebutton /#productpurchasebutton world 내 상품 구매 버튼의 기능을 관리하는 클래스입니다 producterror /#producterror 상품 관련 요청이 실패한 원인을 나타내는 오류 코드입니다 officialcurrencybalancerequest /#officialcurrencybalancerequest zepeto 공식 재화(zem)의 잔액을 가져오기 위한 비동기 요청을 나타냅니다 baseresponse class 응답 클래스의 기본 클래스입니다 속성 이름 형식 설명 issuccess boolean 요청의 성공 여부를 나타냅니다 정상적으로 완료되면 true로 설정됩니다 message string 요청 결과를 설명합니다 baserequest class · extends baseapirequest 응답 데이터로 제네릭 타입 tresponse 를 받는 baserequest 클래스입니다 속성 이름 형식 설명 responsedata tresponse 제네릭 타입 tresponse 의 응답 데이터입니다 productlistresponse class · extends productbaseresponse /#productbaseresponse productlistresponse 클래스는 api 호출 결과와 가져온 상품 정보 목록을 제공합니다 속성 이름 형식 설명 products productrecord\[] /#productrecord 상품 정보 목록입니다 productbaseresponse class · extends baseresponse /#baseresponse 상품 관련 응답 클래스의 기본 클래스입니다 속성 이름 형식 설명 errorcode producterror /#producterror 실패한 상품 요청의 오류 코드를 가져옵니다 productresponse class · extends productbaseresponse /#productbaseresponse productresponse 클래스는 api 호출 결과와 가져온 상품 정보를 제공합니다 속성 이름 형식 설명 product productrecord /#productrecord 상품 정보입니다 purchaseresponse class · extends productbaseresponse /#productbaseresponse productresponse 클래스는 api 호출 결과와 구매 정보를 제공합니다 속성 이름 형식 설명 userid string 구매를 진행한 플레이어의 사용자 id입니다 productid string 구매한 world 내 상품의 id입니다 price number 구매한 world 내 상품의 가격입니다 receiptid string 구매의 영수증 id입니다 purchasedat date world 내 상품을 구매한 날짜와 시간입니다 currencylistresponse class · extends productbaseresponse /#productbaseresponse currencylistresponse 클래스는 api 호출 결과와 재화 정보 목록을 제공합니다 속성 이름 형식 설명 currencies currencyrecord\[] /#currencyrecord 재화 정보 목록입니다 currencyresponse class · extends productbaseresponse /#productbaseresponse currencyresponse 클래스는 api 호출 결과와 재화 정보를 제공합니다 속성 이름 형식 설명 currency currencyrecord /#currencyrecord 재화 정보입니다 productrecord class 상품 정보입니다 속성 이름 형식 설명 productid string 상품 id입니다 name string 상품 이름입니다 price number 상품 가격입니다 ispurchased boolean 사용자가 해당 상품을 구매했는지 여부를 나타냅니다 비소모성 상품에만 적용됩니다 itempackageunits itempackageunitrecord\[] /#itempackageunitrecord producttype 이 itempackage 인 경우 상품에 포함된 아이템입니다 currencypackageunits currencypackageunitrecord\[] /#currencypackageunitrecord producttype 이 currencypackage 인 경우 상품에 포함된 재화입니다 producttype producttype /#producttype 상품의 producttype 을(를) 반환합니다 purchasetype purchasetype /#purchasetype 상품의 purchasetype 을(를) 반환합니다 productstatus productstatus /#productstatus 상품의 productstatus 을(를) 반환합니다 currencytype currencytype /#currencytype 상품 구매에 사용되는 재화의 유형을 반환합니다 currencyid string 상품 구매에 사용되는 재화의 id를 반환합니다 currencyname string 상품 구매에 사용되는 재화의 이름을 반환합니다 메서드 getcurrencysprite getcurrencysprite() → sprite 상품 구매에 사용되는 재화의 이미지를 반환합니다 반환값 sprite currencyrecord class 재화 정보입니다 속성 이름 형식 설명 currencyid string 재화 id입니다 name string 재화 이름입니다 isofficialcurrency boolean 해당 재화가 zepeto 공식 재화(zem)인지 world 내 재화인지를 나타냅니다 itempackageunitrecord class 아이템 상품 패키지에 포함된 개별 상품의 세부 정보입니다 속성 이름 형식 설명 productid string 상품 id입니다 itemname string 아이템 이름입니다 quantity bigint 아이템 수량입니다 currencypackageunitrecord class 재화 상품 패키지에 포함된 개별 재화의 세부 정보입니다 속성 이름 형식 설명 currencyid string 재화 id입니다 currencyname string 재화 이름입니다 quantity bigint 재화 수량입니다 producttype enum 상품 유형을 나타내는 열거형입니다 이름 값 설명 item 0 단일 아이템 상품입니다 itempackage 1 여러 아이템을 포함하는 아이템 상품 패키지입니다 currencypackage 2 여러 재화를 포함하는 재화 상품 패키지입니다 purchasetype enum 상품 구매 유형을 나타내는 열거형입니다 이름 값 설명 consumable 0 소모성 상품입니다 nonconsumable 1 비소모성 상품입니다 productstatus enum 상품 상태를 나타내는 열거형입니다 이름 값 설명 active 0 활성 상태입니다 inactive 1 비활성 상태입니다 forbidden 2 이용 기간 만료로 인해 금지된 상태입니다 currencytype enum 재화 유형을 나타내는 열거형입니다 이름 값 설명 officialcurrency 0 zepeto 공식 재화(zem) usercurrency 1 world 내 재화입니다 productservice class productservice 는 world 내 상품과 관련된 작업을 관리합니다 이 서비스를 통해 플레이어는 world 내 상품 정보에 접근하고 구매를 진행할 수 있습니다 이벤트 이름 형식 설명 onpurchasecompleted (static) unityevent\<productrecord, purchaseresponse> world 내 상품 구매에 성공했을 때 발생하는 이벤트입니다 리스너를 추가할 수 있으며, productrecord (구매한 상품 정보)와 purchaseresponse (구매 결과 정보) 인스턴스가 인자로 전달됩니다 onpurchasefailed (static) unityevent\<productrecord, productbaseresponse> world 내 상품 구매에 실패했을 때 발생하는 이벤트입니다 리스너를 추가할 수 있으며, productrecord (구매를 시도한 상품 정보)와 purchaseresponse (실패한 구매 결과 정보) 인스턴스가 인자로 전달됩니다 메서드 getproductsasync static getproductsasync(productids string\[]) → baserequest\<productlistresponse> 전달된 상품 id를 기준으로 world 내 상품 목록을 가져오는 비동기 메서드입니다 매개변수 형식 설명 productids string\[] 가져올 상품들의 id입니다 반환값 baserequest\<productlistresponse> /#baserequest — baserequest 객체입니다 비동기 처리가 완료되면 responsedata 속성을 통해 productlistresponse 객체에 접근할 수 있습니다 getproductasync static getproductasync(productid string) → baserequest\<productresponse> 전달된 상품 id를 기준으로 world 내 상품 정보를 가져오는 비동기 메서드입니다 매개변수 형식 설명 productid string 가져올 상품의 id입니다 반환값 baserequest\<productresponse> /#baserequest — baserequest 객체입니다 비동기 처리가 완료되면 responsedata 속성을 통해 productresponse 객체에 접근할 수 있습니다 purchaseproductasync static purchaseproductasync(product productrecord, reason? string) → baserequest\<purchaseresponse> 전달된 상품 정보를 기준으로 world 내 상품을 구매하는 비동기 메서드입니다 매개변수 형식 설명 product productrecord /#productrecord 구매할 상품의 productrecord 인스턴스입니다 reason (선택 사항) string 구매에 대한 설명입니다 반환값 baserequest\<purchaseresponse> /#baserequest — baserequest 객체입니다 비동기 처리가 완료되면 responsedata 속성을 통해 purchaseresponse 객체에 접근할 수 있습니다 purchaseproductasync static purchaseproductasync(productid string, reason? string) → baserequest\<purchaseresponse> 전달된 상품 id를 기준으로 world 내 상품을 구매하는 비동기 메서드입니다 매개변수 형식 설명 productid string 구매할 상품의 id입니다 reason (선택 사항) string 구매에 대한 설명입니다 반환값 baserequest\<purchaseresponse> /#baserequest — baserequest 객체입니다 비동기 처리가 완료되면 responsedata 속성을 통해 purchaseresponse 객체에 접근할 수 있습니다 getcurrenciesasync static getcurrenciesasync() → baserequest\<currencylistresponse> 재화 목록을 가져오는 비동기 메서드입니다 처리가 완료되면 재화 목록을 얻을 수 있으며, responsedata 속성을 통해 currencylistresponse 객체에 접근할 수 있습니다 반환값 baserequest\<currencylistresponse> /#baserequest getcurrencyasync static getcurrencyasync(currencyid string) → baserequest\<currencyresponse> 전달된 상품 id를 기준으로 world 내 재화 정보를 가져오는 비동기 메서드입니다 매개변수 형식 설명 currencyid string 가져올 재화의 id입니다 반환값 baserequest\<currencyresponse> /#baserequest — baserequest 객체입니다 비동기 처리가 완료되면 responsedata 속성을 통해 currencyresponse 객체에 접근할 수 있습니다 openpurchaseui static openpurchaseui(product productrecord) → void 이 메서드는 world 내 상품 구매 ui를 엽니다 매개변수 형식 설명 product productrecord /#productrecord 구매할 상품의 productrecord 인스턴스입니다 productpurchasebutton class world 내 상품 구매 버튼의 기능을 관리하는 클래스입니다 속성 이름 형식 설명 productid string 구매 가능한 world 내 상품의 id를 가져옵니다 product productrecord /#productrecord productid 에 연결된 world 내 상품 정보를 가져옵니다 메서드 setproductid setproductid(productid string) → void 이 버튼으로 구매할 수 있는 world 내 상품의 id를 설정합니다 매개변수 형식 설명 productid string 상품 id입니다 producterror enum 상품 관련 요청이 실패한 원인을 나타내는 오류 코드입니다 이름 값 설명 unknown 1 오류 알 수 없는 오류입니다 networkerror 0 오류 연결 끊김이나 불안정한 연결 등 네트워크 문제와 관련된 오류입니다 usercanceled 1 오류 사용자가 요청을 취소했습니다 productrefreshresponseerror 2 오류 요청의 상품 메타데이터가 유효하지 않습니다 itempackageproductsresponseerror 3 오류 아이템 상품 패키지 내 하나 이상의 아이템 정보를 가져오지 못했습니다 iapcarderror 4 오류 재화 상품 패키지 내 하나 이상의 재화 정보를 가져오지 못했습니다 productpricechanged 4001 오류 상품 가격이 일치하지 않습니다 productalreadypurchased 4002 오류 이미 구매한 상품입니다 balanceofficialcurrencynotenough 4003 오류 구매에 필요한 zepeto 공식 재화(zem) 잔액이 부족합니다 balanceusercurrencynotenough 4004 오류 구매에 필요한 world 내 재화 잔액이 부족합니다 productnotactive 4005 오류 상품이 활성 상태가 아닙니다 invalidcreator 4006 오류 플레이어의 사용자 id가 world 크리에이터의 사용자 id와 다릅니다 이 오류는 unity 에디터를 사용하는 개발 환경에서만 발생합니다 officialcurrencybalancerequest class · extends baserequest\<balanceresponse> /#baserequest zepeto 공식 재화(zem)의 잔액을 가져오기 위한 비동기 요청을 나타냅니다