Envoyer un message direct API

14min

Vous pouvez envoyer des messages directs à d'autres utilisateurs dans le monde ZEPETO en utilisant l'API d'envoi de messages directs (DM).
Lors de l'utilisation de l'API d'envoi de messages directs (DM) dans un monde lancé, un lien pour entrer dans le monde est automatiquement fourni en bas du message, ce qui est bon pour promouvoir le monde.
Veuillez vous assurer de suivre les précautions lors de l'utilisation.
﻿
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 d'envoi de messages directs
Pour utiliser l'API d'envoi de DM, ajoutez l'instruction d'importation ci-dessous.
TypeScript
import { SocialService } from 'ZEPETO.Module.Social';
import { SocialService } from 'ZEPETO.Module.Social';
﻿
﻿
Fonction principale d'envoi de DM
Déclaration
public static OpenPopupDirectMessage($sendMessage: string, $userIds?: string[], $onComplete?: System.Action$1):void;
Paramètres
paramètre
Description
sendMessage
Ceci est un paramètre requis. C'est le corps du message que vous souhaitez envoyer. S'il est vide ou nul, la transmission sera considérée comme un échec.
userIds
Ceci est un paramètre optionnel.

Si vous passez userIds
- L'interface de sélection est configurée avec la liste d'ID utilisateur correspondante.

Lorsque userIds ne sont pas passés ou qu'une liste vide est passée
- L'interface de sélection est construite avec la liste de suivre/suivis de l'utilisateur envoyant le message.
onComplete
Ceci est un rappel à appeler lorsque l'envoi du message est terminé ou échoue.
ÉtatDuMessageDirect
Réponse
Description
Annuler
Lorsque la fenêtre contextuelle est fermée manuellement ou si l'envoi échoue.
EnvoiComplet
Lorsque la demande d'envoi est terminée et qu'elle se ferme.
﻿
Situation par Code d'Erreur
Réponse
Description
31002
Cela se produit si au moins un UserID incorrect (un UserID qui n'existe pas) est inclus lors de la saisie de la liste des ID utilisateurs dans le paramètre userIds.
37011
Cela se produit lorsque vous essayez d'envoyer un message sous un compte invité.
8001
Cela se produit lorsque vous envoyez continuellement le même message à plusieurs reprises. Il peut être envoyé une fois toutes les 10 secondes.
2001
Cela se produit lorsque le contenu du message dans le champ ‘Envoyer’ est soit vide, contient uniquement un espace, ou dépasse 1000 caractères.
0
Cas d'erreur de connexion réseau tels que déconnexion réseau, instabilité de connexion, et autres situations d'erreur générales.
-1
Erreur non identifiable.
﻿
Exemple d'utilisation
Entrez directement l'expéditeur et envoyez
1) Veuillez ajouter le bouton Envoyer DM au Canvas.
2) Veuillez écrire le code d'exemple comme ci-dessous.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SocialService, DirectMessagePopupState } from 'ZEPETO.Module.Social';
import { Button } from "UnityEngine.UI";
import { WorldService } from 'ZEPETO.World';
 
export default class SendDirectMessage extends ZepetoScriptBehaviour {
 
    // Variable pour stocker le message direct
    public message: string;
 
    // Tableau d'IDs d'utilisateur pour envoyer le message direct
    public userIds: string[];
 
    // Référence au composant UI du bouton
    public sendDMButton: Button;
 
    Start() {
 
        this.sendDMButton.onClick.AddListener(() => {
 
            // Vérifiez si mon ID est inclus dans le tableau userIds et retournez si c'est le cas
            if (this.userIds.includes(WorldService.userId)) {
                console.log("userIds contient mon userId");
                return;
            }
 
            // Ouvrez une fenêtre contextuelle pour envoyer un message direct en utilisant le SocialService
            SocialService.OpenPopupDirectMessage(this.message, this.userIds, (popupState: DirectMessagePopupState) => {
 
                // Vérifiez l'état de la fenêtre contextuelle du message direct
                if (popupState === DirectMessagePopupState.Cancel) {
                    console.log("Vous avez fermé la fenêtre contextuelle ou échoué à envoyer le message");
                } else if (popupState === DirectMessagePopupState.SendComplete) {
                    console.log("Le message DM a été envoyé avec succès, et la fenêtre contextuelle est fermée.");
                }
            });
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SocialService, DirectMessagePopupState } from 'ZEPETO.Module.Social';
import { Button } from "UnityEngine.UI";
import { WorldService } from 'ZEPETO.World';
 
export default class SendDirectMessage extends ZepetoScriptBehaviour {
 
    // Variable pour stocker le message direct
    public message: string;
 
    // Tableau d'IDs d'utilisateur pour envoyer le message direct
    public userIds: string[];
 
    // Référence au composant UI du bouton
    public sendDMButton: Button;
 
    Start() {
 
        this.sendDMButton.onClick.AddListener(() => {
 
            // Vérifiez si mon ID est inclus dans le tableau userIds et retournez si c'est le cas
            if (this.userIds.includes(WorldService.userId)) {
                console.log("userIds contient mon userId");
                return;
            }
 
            // Ouvrez une fenêtre contextuelle pour envoyer un message direct en utilisant le SocialService
            SocialService.OpenPopupDirectMessage(this.message, this.userIds, (popupState: DirectMessagePopupState) => {
 
                // Vérifiez l'état de la fenêtre contextuelle du message direct
                if (popupState === DirectMessagePopupState.Cancel) {
                    console.log("Vous avez fermé la fenêtre contextuelle ou échoué à envoyer le message");
                } else if (popupState === DirectMessagePopupState.SendComplete) {
                    console.log("Le message DM a été envoyé avec succès, et la fenêtre contextuelle est fermée.");
                }
            });
        });
    }
}
﻿
﻿
3) Après avoir écrit le script, retournez à l'éditeur Unity et faites glisser le bouton dans l'inspecteur pour le définir. Entrez le corps du message et l'UserID de l'utilisateur cible pour le message.
Jusqu'à 20 personnes seront affichées dans l'interface utilisateur, alors entrez jusqu'à 20 personnes.
4) Lorsque vous appuyez sur le bouton Envoyer DM, l'interface de la liste d'amis apparaît.
Sélectionnez l'utilisateur cible et cliquez sur Envoyer.
﻿
﻿
5) Si l'envoi du DM est réussi, une interface Toast apparaîtra indiquant le succès, et un journal sera généré par le script d'exemple.
﻿
﻿
6) De plus, un DM est arrivé pour targetUser.
Lors des tests dans un monde pré-lancement, seul le message est envoyé.
﻿
﻿
Lors de l'utilisation de l'API d'envoi de DM dans un monde lancé, le lien du monde est également envoyé.
﻿
﻿
Si une erreur se produit, comme l'envoi de messages en continu ou si le contenu du message est vide, la transmission du DM sera traitée comme un échec.
﻿
﻿
Envoyer en utilisant l'interface de liste de suivi/suiveurs
1) Veuillez ajouter un bouton au canevas.
2) Veuillez écrire le code d'exemple comme ci-dessous.
Si vous passez une liste vide au paramètre targetUserID, l'interface de liste de suivi/suiveurs apparaîtra.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SocialService, DirectMessagePopupState } from 'ZEPETO.Module.Social';
import { Button } from "UnityEngine.UI";
 
export default class SendDirectMessage extends ZepetoScriptBehaviour {
 
    // Variable pour stocker le message direct
    public message: string;
 
    // Référence au composant UI du bouton
    public sendDMButton: Button;
 
    // Variable privée pour stocker un tableau d'IDs d'utilisateurs, initialisé à null
    private emptyIds: string[];
 
 
    Start() {
 
        this.sendDMButton.onClick.AddListener(() => {
 
            // Ouvrir une fenêtre contextuelle pour envoyer un message direct en utilisant le SocialService
            // Utilisez le contenu du message de la classe et un tableau vide d'IDs d'utilisateurs
            SocialService.OpenPopupDirectMessage(this.message, this.emptyIds, (popupState: DirectMessagePopupState) => {
 
                // Vérifiez l'état retourné de la fenêtre contextuelle de message direct
                if (popupState === DirectMessagePopupState.Cancel) {
                    console.log("Vous avez fermé la fenêtre contextuelle ou échoué à envoyer le message");
                } else if (popupState === DirectMessagePopupState.SendComplete) {
                    console.log("Le message DM a été envoyé avec succès, et la fenêtre contextuelle est fermée.");
                }
            });
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SocialService, DirectMessagePopupState } from 'ZEPETO.Module.Social';
import { Button } from "UnityEngine.UI";
 
export default class SendDirectMessage extends ZepetoScriptBehaviour {
 
    // Variable pour stocker le message direct
    public message: string;
 
    // Référence au composant UI du bouton
    public sendDMButton: Button;
 
    // Variable privée pour stocker un tableau d'IDs d'utilisateurs, initialisé à null
    private emptyIds: string[];
 
 
    Start() {
 
        this.sendDMButton.onClick.AddListener(() => {
 
            // Ouvrir une fenêtre contextuelle pour envoyer un message direct en utilisant le SocialService
            // Utilisez le contenu du message de la classe et un tableau vide d'IDs d'utilisateurs
            SocialService.OpenPopupDirectMessage(this.message, this.emptyIds, (popupState: DirectMessagePopupState) => {
 
                // Vérifiez l'état retourné de la fenêtre contextuelle de message direct
                if (popupState === DirectMessagePopupState.Cancel) {
                    console.log("Vous avez fermé la fenêtre contextuelle ou échoué à envoyer le message");
                } else if (popupState === DirectMessagePopupState.SendComplete) {
                    console.log("Le message DM a été envoyé avec succès, et la fenêtre contextuelle est fermée.");
                }
            });
        });
    }
}
﻿
﻿
3) Après avoir écrit le script, retournez à l'éditeur Unity et faites glisser le bouton dans l'inspecteur pour le définir. Ensuite, veuillez entrer le corps du message.
4) Lorsque vous appuyez sur le bouton Envoyer DM, l'interface Suivant/Abonné apparaît.
Sélectionnez l'utilisateur cible et cliquez sur Envoyer. (Jusqu'à 5 personnes peuvent être sélectionnées)
﻿
﻿
Vous pouvez envoyer des DM à un maximum de 5 personnes à la fois.
Vous ne pouvez pas vous envoyer un DM.
Le nombre réel d'utilisateurs suivis/suivants peut différer du nombre d'utilisateurs affichés dans la fenêtre contextuelle Envoyer DM.
C'est parce que les utilisateurs qui peuvent être sélectionnés sont filtrés et affichés.
Si vous sélectionnez un utilisateur qui a bloqué la réception de DMs, cela sera considéré comme un échec et les DMs ne seront pas envoyés.
Si vous appelez l'API Envoyer DM fréquemment, elle sera restreinte et la transmission échouera.
Vous pouvez envoyer une fois toutes les 10 secondes. Veuillez faire attention à ne pas envoyer des DMs indifféremment.
Si le message que vous envoyez contient une URL, il ne fonctionnera pas correctement, donc l'envoi de messages contenant des URL est interdit.
Si le message envoyé est vide ou nul, il sera considéré comme un échec. Veuillez vous assurer d'écrire le contenu du message.
﻿

paramètre	Description
sendMessage	Ceci est un paramètre requis. C'est le corps du message que vous souhaitez envoyer. S'il est vide ou nul, la transmission sera considérée comme un échec.
userIds	Ceci est un paramètre optionnel. Si vous passez userIds - L'interface de sélection est configurée avec la liste d'ID utilisateur correspondante. Lorsque userIds ne sont pas passés ou qu'une liste vide est passée - L'interface de sélection est construite avec la liste de suivre/suivis de l'utilisateur envoyant le message.
onComplete	Ceci est un rappel à appeler lorsque l'envoi du message est terminé ou échoue.

Réponse	Description
Annuler	Lorsque la fenêtre contextuelle est fermée manuellement ou si l'envoi échoue.
EnvoiComplet	Lorsque la demande d'envoi est terminée et qu'elle se ferme.

Réponse	Description
31002	Cela se produit si au moins un UserID incorrect (un UserID qui n'existe pas) est inclus lors de la saisie de la liste des ID utilisateurs dans le paramètre userIds.
37011	Cela se produit lorsque vous essayez d'envoyer un message sous un compte invité.
8001	Cela se produit lorsque vous envoyez continuellement le même message à plusieurs reprises. Il peut être envoyé une fois toutes les 10 secondes.
2001	Cela se produit lorsque le contenu du message dans le champ ‘Envoyer’ est soit vide, contient uniquement un espace, ou dépasse 1000 caractères.
0	Cas d'erreur de connexion réseau tels que déconnexion réseau, instabilité de connexion, et autres situations d'erreur générales.
-1	Erreur non identifiable.

Mis à jour 10 Oct 2024

Cette page vous a-t-elle aidée?

Tableau des leaders

Récupération du statut de suivi depuis l'écran de la liste des membres de la salle