API Pemberian Hadiah

11min
Anda dapat menggunakan API gifting untuk memberikan barang pakaian kepada pengguna lain di ZEPETO World.
Namun, saat menggunakan API, barang milik pengirim akan dikurangi.
﻿
Instal
Jendela → Pengelola Paket → Paket ZEPETO.World Harap instal versi 1.21.14 atau lebih tinggi terlebih dahulu.
Setelah itu, harap instal paket ‘ZEPETO.Module’ dengan versi 1.0.7 atau lebih tinggi.
Pastikan bahwa aplikasi ZEPETO menjalankan versi 3.46.000 atau lebih tinggi.
﻿
﻿
API Gifting
Untuk menggunakan API gifting, tambahkan pernyataan impor di bawah ini.
TypeScript
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
﻿
﻿
Jika Anda tertarik dengan Gifting API, silakan merujuk ke dokumentasi:
📘 Silakan merujuk ke panduan berikut. [ZEPETO.Module.Shop API]
﻿
Di editor Unity, Anda dapat menguji kasus keberhasilan dan kegagalan. Bahkan jika pemberian berhasil, itu tidak akan mengurangi mata uang, dan hadiah tidak akan dikirimkan kepada penerima.
Selama pengujian mobile melalui kode QR atau tautan uji, transaksi yang berhasil akan mengakibatkan pengurangan mata uang yang sebenarnya dan hadiah akan dikirimkan kepada penerima.
﻿
Contoh penggunaan
Silakan tambahkan tombol Kirim Hadiah ke Kanvas.
Silakan tulis kode contoh seperti di bawah ini.
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,
                "Hai Ini untukmu!",
                (response: ItemGiftResponse) => {  // onComplete callback
                    console.log(`Hadiah berhasil dikirim! Saldo ZEPETO Coin ${response.coin}, Saldo ZEM ${response.zem}`);
                },
                (error: ErrorCode) => {  // onFailure callback
                    console.error("Kesalahan saat mengirim hadiah:", 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,
                "Hai Ini untukmu!",
                (response: ItemGiftResponse) => {  // onComplete callback
                    console.log(`Hadiah berhasil dikirim! Saldo ZEPETO Coin ${response.coin}, Saldo ZEM ${response.zem}`);
                },
                (error: ErrorCode) => {  // onFailure callback
                    console.error("Kesalahan saat mengirim hadiah:", error);
                }
            );
        });
    }
}
﻿
﻿
Setelah menulis skrip, sambungkan tombol di inspector dan masukkan userID dan itemID dari orang yang akan menerima hadiah.
📘 Silakan merujuk ke panduan berikut tentang cara mendapatkan UserId Pemain Zepeto. [ZEPETO Player﻿]
﻿
Untuk menguji kasus keberhasilan atau kegagalan, buat kode QR dan kemudian uji di perangkat seluler Anda.
Namun, harap dicatat bahwa barang pengirim akan dipotong.
﻿
Ketika mengirim hadiah berhasil
Ketika Anda mengklik tombol, UI pop-up untuk mengirim hadiah akan muncul.
﻿
﻿
Jika hadiah berhasil dikirim, UI Toast akan muncul untuk menunjukkan keberhasilan, dan skrip contoh akan menghasilkan log
﻿
﻿
﻿
﻿
Selain itu, sebuah hadiah telah tiba untuk targetUser.
﻿
﻿
Ketika pengiriman hadiah gagal
Jika kasus sesuai dengan ErrorCode, pesan kesalahan akan ditampilkan di UI Toast, dan skrip contoh akan mengeluarkan kode kesalahan yang sesuai.
﻿
﻿
﻿
﻿
Diperbarui 11 Oct 2024
Apakah halaman ini membantu Anda?
SEBELUMNYA
ZEPETO Mannequin
BERIKUTNYA
Menghasilkan Uang dengan Menambahkan Iklan di Dunia