API de cadeaux

11min
Vous pouvez utiliser l'API de cadeaux pour offrir des vêtements à d'autres utilisateurs dans le monde ZEPETO.
Cependant, lors de l'utilisation de l'API, les biens de l'expéditeur seront déduits.
﻿
Installer
Fenêtre → Gestionnaire de paquets → Paquet ZEPETO.World Veuillez d'abord installer la version 1.21.14 ou supérieure.
Ensuite, veuillez installer le paquet ‘ZEPETO.Module’ avec une version de 1.0.7 ou supérieure.
Assurez-vous que l'application ZEPETO fonctionne avec la version 3.46.000 ou supérieure.
﻿
﻿
API de cadeaux
Pour utiliser l'API de cadeaux, ajoutez l'instruction d'importation ci-dessous.
TypeScript
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
﻿
﻿
Si vous êtes intéressé par l'API de Gifting, consultez la documentation :
📘 Veuillez consulter le guide suivant. [API ZEPETO.Module.Shop]
﻿
Dans l'éditeur Unity, vous pouvez tester à la fois les cas de succès et d'échec. Même si le cadeau est réussi, il ne déduira aucune monnaie, et le cadeau ne sera pas livré au destinataire.
Lors des tests mobiles via des codes QR ou des liens de test, les transactions réussies entraîneront une déduction réelle de la monnaie et le cadeau sera livré au destinataire.
﻿
Exemple d'utilisation
Veuillez ajouter un bouton Envoyer un cadeau au Canvas.
Veuillez écrire le code d'exemple comme ci-dessous.
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,
                "Salut, ceci est pour vous !",
                (response: ItemGiftResponse) => {  // callback onComplete
                    console.log(`Cadeau envoyé avec succès ! Solde ZEPETO Coin ${response.coin}, Solde ZEM ${response.zem}`);
                },
                (error: ErrorCode) => {  // callback onFailure
                    console.error("Erreur lors de l'envoi du cadeau:", 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,
                "Salut, ceci est pour vous !",
                (response: ItemGiftResponse) => {  // callback onComplete
                    console.log(`Cadeau envoyé avec succès ! Solde ZEPETO Coin ${response.coin}, Solde ZEM ${response.zem}`);
                },
                (error: ErrorCode) => {  // callback onFailure
                    console.error("Erreur lors de l'envoi du cadeau:", error);
                }
            );
        });
    }
}
﻿
﻿
Après avoir écrit le script, connectez le bouton dans l'inspecteur et entrez l'ID utilisateur et l'ID d'article de la personne qui recevra le cadeau.
📘 Veuillez vous référer au guide suivant sur la façon d'obtenir l'UserId du joueur Zepeto. [ZEPETO Player﻿]
﻿
Pour tester les cas de succès ou d'échec, créez un code QR puis testez-le sur votre appareil mobile.
Cependant, veuillez noter que les biens de l'expéditeur seront déduits.
﻿
Lorsque l'envoi d'un cadeau est réussi
Lorsque vous cliquez sur le bouton, une interface utilisateur contextuelle pour envoyer un cadeau apparaîtra.
﻿
﻿
Si le cadeau est envoyé avec succès, une interface utilisateur Toast apparaîtra pour indiquer le succès, et le script d'exemple générera un journal
﻿
﻿
﻿
﻿
De plus, un cadeau est arrivé pour targetUser.
﻿
﻿
Lorsque l'envoi d'un cadeau échoue
Si le cas correspond à ErrorCode, un message d'erreur sera affiché dans l'interface Toast, et le script d'exemple affichera le code d'erreur correspondant.
﻿
﻿
﻿
﻿
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
Mannequin ZEPETO
Gagner de l'argent en ajoutant des publicités dans le monde