การให้ API

10min
คุณสามารถใช้ API การให้ของขวัญเพื่อมอบเสื้อผ้าให้กับผู้ใช้คนอื่นภายใน ZEPETO World.
อย่างไรก็ตาม เมื่อใช้ API สินค้าของผู้ส่งจะถูกหักออก.
﻿
ติดตั้ง
Window → Package Manager → ZEPETO.World Package กรุณาติดตั้งเวอร์ชัน 1.21.14 หรือสูงกว่าก่อน.
หลังจากนั้น กรุณาติดตั้งแพ็คเกจ ‘ZEPETO.Module’ ที่มีเวอร์ชัน 1.0.7 หรือสูงกว่า.
ตรวจสอบให้แน่ใจว่าแอป ZEPETO กำลังทำงานในเวอร์ชัน 3.46.000 หรือสูงกว่า.
﻿
﻿
API การให้ของขวัญ
ในการใช้ API การให้ของขวัญ ให้เพิ่มคำสั่งนำเข้าด้านล่าง.
TypeScript
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
﻿
﻿
หากคุณสนใจใน Gifting API โปรดดูเอกสาร:
📘 โปรดดูคู่มือต่อไปนี้. [ZEPETO.Module.Shop API]
﻿
ใน Unity editor คุณสามารถทดสอบทั้งกรณีที่สำเร็จและล้มเหลว แม้ว่าการให้ของขวัญจะสำเร็จ มันจะไม่หักเงินใด ๆ และของขวัญจะไม่ถูกส่งไปยังผู้รับ.
ในระหว่างการทดสอบบนมือถือผ่าน QR codes หรือ ลิงก์ทดสอบ การทำธุรกรรมที่สำเร็จจะส่งผลให้มีการหักเงินจริงและของขวัญจะถูกส่งไปยังผู้รับ.
﻿
ตัวอย่างการใช้งาน
กรุณาเพิ่มปุ่มส่งของขวัญไปยัง Canvas.
กรุณาเขียนโค้ดตัวอย่างตามด้านล่างนี้.
TypeScript
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 Coin ${response.coin}, ยอดเงิน ZEM ${response.zem}`);
                },
                (error: ErrorCode) => {  // onFailure callback
                    console.error("เกิดข้อผิดพลาดในการส่งของขวัญ:", error);
                }
            );
        });
    }
}
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 Coin ${response.coin}, ยอดเงิน ZEM ${response.zem}`);
                },
                (error: ErrorCode) => {  // onFailure callback
                    console.error("เกิดข้อผิดพลาดในการส่งของขวัญ:", error);
                }
            );
        });
    }
}
﻿
﻿
หลังจากเขียนสคริปต์แล้ว ให้เชื่อมต่อปุ่มใน Inspector และกรอก userID และ itemID ของผู้ที่จะได้รับของขวัญ.
📘 โปรดดูคู่มือต่อไปนี้เกี่ยวกับวิธีการรับ UserId ของผู้เล่น Zepeto.[ผู้เล่น ZEPETO﻿]
﻿
เพื่อทดสอบกรณีสำเร็จหรือไม่สำเร็จ ให้สร้าง QR code และทดสอบบนอุปกรณ์มือถือของคุณ.
อย่างไรก็ตาม โปรดทราบว่าสินค้าของผู้ส่งจะถูกหักออก.
﻿
เมื่อการส่งของขวัญสำเร็จ
เมื่อคุณคลิกปุ่ม UI ป๊อปอัพสำหรับการส่งของขวัญจะปรากฏขึ้น.
﻿
﻿
หากของขวัญถูกส่งสำเร็จ UI Toast จะปรากฏขึ้นเพื่อแสดงความสำเร็จ และสคริปต์ตัวอย่างจะสร้างบันทึก
﻿
﻿
﻿
﻿
นอกจากนี้ ยังมีของขวัญมาถึงสำหรับ targetUser.
﻿
﻿
เมื่อการส่งของขวัญล้มเหลว
หากกรณีตรงกับ ErrorCode จะมีข้อความแสดงข้อผิดพลาดใน Toast UI และสคริปต์ตัวอย่างจะส่งออกโค้ดข้อผิดพลาดที่ตรงกัน.
﻿
﻿
﻿
﻿
อัปเดต 11 Oct 2024
หน้านี้ช่วยคุณได้หรือไม่?
สร้างรายได้จากโลกของคุณ! การตั้งค่าผลิตภัณฑ์และสกุลเงิน
การหาเงินโดยการเพิ่มโฆษณาภายในโลก