API de cadeaux
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.
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.
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.
