Utilisation de la fonction de chat vocal

25min
La version préliminaire du package Zepeto.Voice.Chat permet le chat vocal dans le Monde.
﻿
Installer ZEPETO.Voice.Chat et définir le mode
1) Installer Windows → Gestionnaire de packages → ZEPETO.Voice.Chat.
Cette fonctionnalité est disponible dans un Monde où des éléments multijoueurs sont implémentés.
Les tests ne sont disponibles que dans le test mobile, pas dans le test éditeur.
En raison de la politique iOS, le volume de l'appareil ne tombe pas à zéro lorsque le microphone est activé dans les mondes avec chat vocal activé.
Le volume de l'appareil tombera à zéro lorsque le microphone sera désactivé.
﻿
﻿
2) Cliquez sur le bouton [▼] dans le menu du milieu de l'écran du projet Unity qui est en cours de développement.
Cliquez sur le bouton [Ouvrir les paramètres du monde] dans le menu contextuel qui apparaît.
﻿
﻿
3) Si le package ZEPETO.Voice.Chat est installé correctement, vous verrez l'option Mode de chat vocal ajoutée.
﻿
﻿
4) En mode de chat vocal, veuillez définir le mode souhaité.
Basique : Utilisez la fonction de chat vocal fournie par défaut.
Script : Utilisez la fonction de chat vocal en implémentant l'API de chat vocal.
Vous pouvez traiter l'entrée/sortie d'accès à la salle pour le chat vocal à l'exécution.
Implémentez le chat vocal pour des équipes distinctes (par exemple, chat vocal de l'équipe rouge et chat vocal de l'équipe bleue)
Détection de l'utilisateur parlant actuellement
﻿
Mode de base : Utilisation de la fonction de chat vocal
Un monde avec le chat vocal en mode de base ressemble à ceci.
Vous pouvez également créer des chats vocaux plus divertissants en utilisant la fonction de modulation vocale.
Le chat vocal est automatiquement activé lors de l'entrée dans le monde avec la fonction de chat vocal.
👍 La première fois que vous utilisez la fonction de chat vocal dans ZEPETO, une fenêtre contextuelle concernant l'accès au microphone apparaîtra.
Vous devez autoriser l'accès pour utiliser la fonction de chat vocal.
Lorsque vous activez la fonction de chat vocal, un bouton apparaît automatiquement dans l'interface utilisateur
﻿
Vous pouvez l'utiliser en touchant le bouton de chat vocal
﻿
﻿
Dans l'application ZEPETO 3.26.000 et supérieure, l'icône du haut-parleur de chat vocal n'apparaît pas.
Si vous souhaitez faire apparaître l'icône de discours, veuillez passer en Mode Script et suivre le guide pour écrire votre propre code.
﻿
Mode Script : Utilisation de l'API VoiceChat
Le mode script permet le chat vocal dans les canaux séparés par équipes.
Veuillez vous référer à la description de la fonction et à l'exemple ci-dessous pour mettre en œuvre la fonctionnalité.
API
Description
OnInitializedEvent
Les API de chat vocal sont disponibles après qu'un événement True se soit produit dans l'événement d'initialisation.
Si cet événement est True, le chat vocal est disponible, et s'il est False, le chat vocal n'est pas disponible.
EnterRoom(RoomProperty roomProperty)
Fonctions pour entrer dans une salle de chat vocal
- Après être entré avec succès dans la salle de chat vocal, le bouton de chat vocal apparaîtra
ExitRoom()
Fonction pour quitter une salle de chat vocal
OnRoomConnectedEvent
Un événement pour vérifier l'état d'entrée dans une salle de chat vocal.
Si cet événement est vrai, l'utilisateur est entré dans la salle de chat vocal ; s'il est faux, l'utilisateur a quitté la salle de chat vocal.
OnSpeechDetectedEvent<string, boolean>
Événement pour détecter l'utilisateur qui parle actuellement dans le chat vocal.
- string est l'userId de l'utilisateur qui parle
- boolean est vrai lorsque l'énoncé commence, faux lorsque l'énoncé se termine
ChangeTeamID(number teamid)
Fonction pour changer le TeamId utilisé dans la salle de chat vocal
- Peut seulement être défini sur une valeur int de 1 ou plus
Classe RoomProperty
API
Description
SetAudioMode
Mode audio à utiliser dans le chat vocal
- AudioMode.Omnidirectionnel: Mode de chat vocal sans atténuation de la voix basée sur la distance
(Vous pouvez l'utiliser avec ou sans le personnage ZEPETO)


- AudioMode.Directionnel: Mode de chat vocal avec atténuation de la voix basée sur la distance
(Le personnage ZEPETO doit être présent dans la scène, car ce mode fonctionne en fonction de l'emplacement du personnage ZEPETO)
SetTeamID
TeamId à utiliser dans le chat vocal pour activer le chat vocal entre les utilisateurs ayant le même TeamId.
- Ne peut être défini qu'à une valeur entière de 1 ou plus
Exemple d'implémentation de chat vocal spécifique à une équipe
Voici un exemple de code pour essayer l'API de chat vocal.
1) Ajoutez un bouton et enregistrez le texte sur le canevas comme indiqué dans l'image ci-dessous pour entrer dans le canal de l'équipe de chat vocal et afficher le journal d'état.
Bouton
Bouton_equipeBleue : Bouton d'entrée pour le chat vocal de l'équipe bleue
Bouton_equipeRouge : Bouton d'entrée pour le chat vocal de l'équipe rouge
Bouton_sortie : Bouton de sortie du chat vocal
Texte
Texte_journal : Texte à afficher pour le journal de chat
Texte_equipe : Texte à afficher pour la liste des membres du même canal de chat vocal
Texte_enCoursDeParler : Texte à afficher pour l'UserId qui parle actuellement dans le chat vocal.
﻿
﻿
2) Créer un projet > Créer > ZEPETO > TypeScript et le renommer en VoiceChatTest.
3) Écrire un script d'exemple comme indiqué ci-dessous.
VoiceChatTest
import { Button, InputField, Text } from 'UnityEngine.UI';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import { AudioMode, RoomProperty, VoiceChatController } from 'ZEPETO.Voice.Chat'
 
export default class VoiceChatTest extends ZepetoScriptBehaviour {
 
    // Déclarez les composants UI comme membres publics
    public BlueTeamButton: Button;
    public RedTeamButton: Button;
    public exitRoomButton: Button;
    public logText: Text;
    public currentTeamIDText: Text;
    public currentSpeakingUserIDsText: Text;
     
    // Déclarez des membres privés pour stocker les ID des utilisateurs parlant et le champ de saisie de l'ID de l'équipe
    private currentSpeakingUserIDs: string[];   
    private teamIDInputField: InputField;
 
    Start() {
        this.currentSpeakingUserIDs = new Array();
         
        // Ajoutez des écouteurs d'événements pour les clics sur les boutons
        this.BlueTeamButton.onClick.AddListener(()=>{
            this.EnterBlueTeam();
        });
        this.RedTeamButton.onClick.AddListener(()=>{
            this.EnterRedTeam();
        });
        this.exitRoomButton.onClick.AddListener(()=>{
            this.ExitVoiceChatRoom();
        });
 
        // Ajoutez des écouteurs d'événements pour le contrôleur de chat vocal
        VoiceChatController.OnInitializedEvent.AddListener(init => this.OnInitialized(init));
        VoiceChatController.OnRoomConnectedEvent.AddListener(connected => this.OnRoomConnected(connected));
        VoiceChatController.OnSpeechDetectedEvent.AddListener((userId, speechDetected) => this.OnSpeechDetected(userId, speechDetected));
         
        this.logText.text = "[VoiceChat] VoiceChatTest Démarrer";
    }
 
    // Méthode OnDestroy appelée lorsque le script est détruit
    OnDestroy() {
        VoiceChatController.OnInitializedEvent.RemoveAllListeners();
        VoiceChatController.OnRoomConnectedEvent.RemoveAllListeners();
        VoiceChatController.OnSpeechDetectedEvent.RemoveAllListeners();
    }
 
    // Méthode appelée lorsque le système de chat vocal est initialisé
    private OnInitialized(initialized: boolean) {
        this.logText.text = "[VoiceChat] OnInitialized: " + initialized;
    }
 
     // Méthode appelée lorsque la salle de chat vocal est connectée
    private OnRoomConnected(connected: boolean) {
        this.logText.text = "[VoiceChat] OnRoomConnected: " + connected;
    }
 
    // Méthode appelée lorsqu'un discours d'utilisateur est détecté ou non détecté
    private OnSpeechDetected(userId: string, speechDetected: boolean) {
        this.logText.text = "[VoiceChat] OnSpeechDetected: " + userId + ", " + speechDetected;
 
        if (speechDetected) {
            this.currentSpeakingUserIDs.push(userId);
        }
        else {
            let index = this.currentSpeakingUserIDs.indexOf(userId);
            this.currentSpeakingUserIDs.splice(index, 1);
        }
 
        let userIds = "[CurrentSpeakingUserIDs]\n";
        for (let i = 0; i < this.currentSpeakingUserIDs.length; i++) {
            userIds += this.currentSpeakingUserIDs[i];
            userIds += "\n";
        }
 
        this.currentSpeakingUserIDsText.text = userIds;
    }
 
    // Méthode pour entrer dans la salle de chat vocal de l'équipe bleue
    public EnterBlueTeam(){
        this.EnterVoiceChatRoom(2);
    }
 
    // Méthode pour entrer dans la salle de chat vocal de l'équipe rouge
    public EnterRedTeam(){
        this.EnterVoiceChatRoom(3);
    }
 
    // Méthode pour entrer dans une salle de chat vocal en fonction de l'index de l'équipe donné
    private EnterVoiceChatRoom(teamIndex: number) {
        console.log("[VoiceChat] EnterVoiceChatRoom");
 
        // Créez un nouvel objet RoomProperty et définissez ses propriétés
        let roomProperty = new RoomProperty();
        roomProperty.SetAudioMode(AudioMode.Omnidirectional);
        roomProperty.SetTeamID(teamIndex);
        VoiceChatController.EnterRoom(roomProperty);
        this.currentTeamIDText.text = "TeamID: " + roomProperty.TeamId.toString();
    }
 
    // Méthode pour quitter la salle de chat vocal
    public ExitVoiceChatRoom() {
        this.logText.text = "[VoiceChat] ExitVoiceChatRoom";
        VoiceChatController.ExitRoom();
    }
 
    // Méthode pour changer l'ID de l'équipe pour l'utilisateur actuel
    public ChangeTeamID() {
        // Obtenez le nouvel ID d'équipe à partir du champ de saisie et parsez-le en tant qu'entier
        let teamID = parseInt(this.teamIDInputField.text);
        this.logText.text = "[VoiceChat] ChangeTeamID: " + teamID;
        this.currentTeamIDText.text = "TeamID: " + teamID.toString();
        // Changez l'ID de l'équipe dans le système de chat vocal
        VoiceChatController.ChangeTeamID(teamID);
    }
 
}
import { Button, InputField, Text } from 'UnityEngine.UI';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import { AudioMode, RoomProperty, VoiceChatController } from 'ZEPETO.Voice.Chat'
 
export default class VoiceChatTest extends ZepetoScriptBehaviour {
 
    // Déclarez les composants UI comme membres publics
    public BlueTeamButton: Button;
    public RedTeamButton: Button;
    public exitRoomButton: Button;
    public logText: Text;
    public currentTeamIDText: Text;
    public currentSpeakingUserIDsText: Text;
     
    // Déclarez des membres privés pour stocker les ID des utilisateurs parlant et le champ de saisie de l'ID de l'équipe
    private currentSpeakingUserIDs: string[];   
    private teamIDInputField: InputField;
 
    Start() {
        this.currentSpeakingUserIDs = new Array();
         
        // Ajoutez des écouteurs d'événements pour les clics sur les boutons
        this.BlueTeamButton.onClick.AddListener(()=>{
            this.EnterBlueTeam();
        });
        this.RedTeamButton.onClick.AddListener(()=>{
            this.EnterRedTeam();
        });
        this.exitRoomButton.onClick.AddListener(()=>{
            this.ExitVoiceChatRoom();
        });
 
        // Ajoutez des écouteurs d'événements pour le contrôleur de chat vocal
        VoiceChatController.OnInitializedEvent.AddListener(init => this.OnInitialized(init));
        VoiceChatController.OnRoomConnectedEvent.AddListener(connected => this.OnRoomConnected(connected));
        VoiceChatController.OnSpeechDetectedEvent.AddListener((userId, speechDetected) => this.OnSpeechDetected(userId, speechDetected));
         
        this.logText.text = "[VoiceChat] VoiceChatTest Démarrer";
    }
 
    // Méthode OnDestroy appelée lorsque le script est détruit
    OnDestroy() {
        VoiceChatController.OnInitializedEvent.RemoveAllListeners();
        VoiceChatController.OnRoomConnectedEvent.RemoveAllListeners();
        VoiceChatController.OnSpeechDetectedEvent.RemoveAllListeners();
    }
 
    // Méthode appelée lorsque le système de chat vocal est initialisé
    private OnInitialized(initialized: boolean) {
        this.logText.text = "[VoiceChat] OnInitialized: " + initialized;
    }
 
     // Méthode appelée lorsque la salle de chat vocal est connectée
    private OnRoomConnected(connected: boolean) {
        this.logText.text = "[VoiceChat] OnRoomConnected: " + connected;
    }
 
    // Méthode appelée lorsqu'un discours d'utilisateur est détecté ou non détecté
    private OnSpeechDetected(userId: string, speechDetected: boolean) {
        this.logText.text = "[VoiceChat] OnSpeechDetected: " + userId + ", " + speechDetected;
 
        if (speechDetected) {
            this.currentSpeakingUserIDs.push(userId);
        }
        else {
            let index = this.currentSpeakingUserIDs.indexOf(userId);
            this.currentSpeakingUserIDs.splice(index, 1);
        }
 
        let userIds = "[CurrentSpeakingUserIDs]\n";
        for (let i = 0; i < this.currentSpeakingUserIDs.length; i++) {
            userIds += this.currentSpeakingUserIDs[i];
            userIds += "\n";
        }
 
        this.currentSpeakingUserIDsText.text = userIds;
    }
 
    // Méthode pour entrer dans la salle de chat vocal de l'équipe bleue
    public EnterBlueTeam(){
        this.EnterVoiceChatRoom(2);
    }
 
    // Méthode pour entrer dans la salle de chat vocal de l'équipe rouge
    public EnterRedTeam(){
        this.EnterVoiceChatRoom(3);
    }
 
    // Méthode pour entrer dans une salle de chat vocal en fonction de l'index de l'équipe donné
    private EnterVoiceChatRoom(teamIndex: number) {
        console.log("[VoiceChat] EnterVoiceChatRoom");
 
        // Créez un nouvel objet RoomProperty et définissez ses propriétés
        let roomProperty = new RoomProperty();
        roomProperty.SetAudioMode(AudioMode.Omnidirectional);
        roomProperty.SetTeamID(teamIndex);
        VoiceChatController.EnterRoom(roomProperty);
        this.currentTeamIDText.text = "TeamID: " + roomProperty.TeamId.toString();
    }
 
    // Méthode pour quitter la salle de chat vocal
    public ExitVoiceChatRoom() {
        this.logText.text = "[VoiceChat] ExitVoiceChatRoom";
        VoiceChatController.ExitRoom();
    }
 
    // Méthode pour changer l'ID de l'équipe pour l'utilisateur actuel
    public ChangeTeamID() {
        // Obtenez le nouvel ID d'équipe à partir du champ de saisie et parsez-le en tant qu'entier
        let teamID = parseInt(this.teamIDInputField.text);
        this.logText.text = "[VoiceChat] ChangeTeamID: " + teamID;
        this.currentTeamIDText.text = "TeamID: " + teamID.toString();
        // Changez l'ID de l'équipe dans le système de chat vocal
        VoiceChatController.ChangeTeamID(teamID);
    }
 
}
﻿
﻿
Description du code
Lorsque le script s'exécute, il enregistrera un événement sur chaque bouton dans la fonction Start() et enregistrera les événements OnInitialized, OnRoomConnected et OnSpeechDetected sur le VoiceChatController.
Lorsque le bouton de l'équipe bleue ou le bouton de l'équipe rouge est cliqué, la fonction EnterVoiceChatRoom() est exécutée et l'utilisateur entre dans la salle de chat vocal en entrant la RoomProperty spécifiée. Les propriétés de la salle dans l'exemple sont les suivantes.
roomProperty.SetAudioMode : AudioMode.Omnidirectional. Le mode audio Omnidirectionnel est un mode où le volume sonne de la même manière, quelle que soit la position du joueur. En revanche, le mode Directionnel est un mode sonore 3D, ce qui signifie que le volume sonnera différemment selon la position du personnage, donc plus le personnage est éloigné, plus le volume sera faible.
roomProperty.SetTeamID : Canal 2 pour l'équipe bleue, Canal 3 pour l'équipe rouge. SetTeamID agit comme un canal dans le chat vocal. Une équipe qui entre dans le canal 2 ne peut discuter vocalement qu'avec les joueurs du canal 2, et une équipe qui entre dans le canal 3 ne peut discuter vocalement qu'avec les joueurs du canal 3.
ExitVoiceChatRoom() quittera le canal de chat vocal de l'équipe actuelle.
OnSpeechDetected() affichera l'ID du joueur qui utilise actuellement le chat vocal dans le canal de l'équipe dans le texte du journal.
﻿
4) Après avoir terminé le script, assignez le bouton et le texte créés à l'étape 1 dans l'inspecteur.
﻿
﻿
5) Exécutez le test sur mobile via le code QR ou le lien de test, et vous pouvez voir que le bouton d'activation du chat vocal est créé lorsque le bouton Entrer dans l'équipe est pressé, et chaque fois qu'un joueur parle, le journal montre quel joueur est dans le chat vocal, comme indiqué dans l'écran suivant.
﻿
﻿
Exemple d'affichage d'une image de bulle de chat vocal
Dans l'application ZEPETO 3.26.000 et les versions ultérieures, l'icône d'énonciation du chat vocal n'apparaît pas.
Si vous souhaitez gérer l'apparition de l'icône d'énonciation, veuillez suivre le guide et écrire votre propre code.
1) Pour afficher une bulle de dialogue au-dessus de la tête du personnage lorsque le joueur est dans le chat vocal, vous devrez créer un prefab qui utilise une image de bulle de dialogue. Importez l'image PNG de bulle de dialogue que vous souhaitez utiliser comme indiqué ci-dessous et changez son type de texture en Sprite.
﻿
﻿
2) Projet > Créer > Prefab et renommez-le en ChatBubble.
﻿
﻿
3) Double-cliquez sur le prefab ChatBubble pour entrer en mode d'édition du prefab. Sélectionnez le prefab ChatBubble et choisissez Transform > Position > Changez la valeur Y à 0.35.
﻿
﻿
4) Créez un Canvas à l'intérieur de l'objet prefab.
Double-cliquez sur le prefab ChatBubble pour entrer en mode d'édition de prefab, puis ajoutez Hiérarchie > UI > Canvas.
Changez les valeurs du composant RectTransform du Canvas comme suit
PosX: 0 , posY: 0
Largeur: 100, hauteur: 100
ÉchelleX: 0.005, ÉchelleY: 0.005, ÉchelleZ: 0.005
Changez le RenderMove du composant Canvas en Espace Mondial.
﻿
﻿
5) Créez une image de bulle de dialogue à l'intérieur du Canvas.
Ajoutez Hiérarchie > UI > Image comme enfant du Canvas, et renommez-le ChatBubbleImage.
Changez les valeurs du composant RectTransform de ChatBubbleImage comme suit
Largeur 42, Hauteur:42
Enregistrez le Sprite d'image que vous avez importé à l'étape 1 comme Image Source dans le composant Image.
﻿
﻿
👍 CONSEIL
Vous pouvez également animer l'image sprite de la bulle de dialogue.
Vous pouvez également utiliser des images de bulles séparées pour différentes équipes.
﻿
6) Projet > Créer > ZEPETO > Créer un TypeScript et le renommer en VoiceChatBubbleController.
7) Écrivez un script d'exemple comme indiqué ci-dessous.
VoiceChatBubbleController
import { GameObject, Object } from 'UnityEngine';
import { KnowSockets, ZepetoPlayers } from 'ZEPETO.Character.Controller'
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import { AudioMode, RoomProperty, VoiceChatController } from 'ZEPETO.Voice.Chat';
 
export default class VoiceChatBubbleController extends ZepetoScriptBehaviour {
 
    // Variable publique GameObject pour stocker le prefab de la bulle de chat vocal
    public voiceChatPrefab: GameObject;
 
    // Carte privée pour stocker les GameObjects associés aux ID d'utilisateur
    private _voiceBubbleMap: Map<string, GameObject> = new Map<string, GameObject>();
 
    Start() {
        // Ajouter des écouteurs d'événements pour le contrôleur de chat vocal
        VoiceChatController.OnInitializedEvent.AddListener(init => this.OnInitialized(init));
        VoiceChatController.OnRoomConnectedEvent.AddListener(connected => this.OnRoomConnected(connected));
        VoiceChatController.OnSpeechDetectedEvent.AddListener((userId, speechDetected) => this.OnSpeechDetected(userId, speechDetected));
    }
 
    // Méthode appelée lorsque le système de chat vocal est initialisé
    private OnInitialized(initialized: boolean) {
        console.log("[VoiceChat] OnInitialized: ");
        this.EnterVoiceChatRoom(1);
    }
 
    // Méthode appelée lorsque la salle de chat vocal est connectée
    private OnRoomConnected(connected: boolean) {
        console.log("[VoiceChat] OnRoomConnected: ");
    }
 
    // Méthode pour entrer dans une salle de chat vocal en fonction de l'index de l'équipe donné
    private EnterVoiceChatRoom(teamIndex: number) {
        console.log("[VoiceChat] EnterVoiceChatRoom");
 
        // Créer un nouvel objet RoomProperty et définir ses propriétés
        let roomProperty = new RoomProperty();
        roomProperty.SetAudioMode(AudioMode.Omnidirectional);
        VoiceChatController.EnterRoom(roomProperty);
    }
 
    // Méthode appelée lorsqu'un discours d'utilisateur est détecté ou non détecté
    private OnSpeechDetected(userId: string, speechDetected: boolean) {
        console.log("[VoiceChat] OnSpeechDetected: " + userId + ", " + speechDetected);
 
        // Vérifier si l'ID d'utilisateur n'est pas dans la carte de bulle vocale et créer une bulle vocale si ce n'est pas le cas
        if (!this._voiceBubbleMap.has(userId)) {
            this.CreateVoiceBubble(userId);
        }
 
        this.SetVoiceBubble(userId, speechDetected);
    }
 
    // Méthode pour définir l'état actif de la bulle vocale pour un ID d'utilisateur donné
    private SetVoiceBubble(userId: string, speechDetected: boolean) {
        const chatBubble = this._voiceBubbleMap.get(userId);
        chatBubble.SetActive(speechDetected);
    }
 
    // Méthode pour créer une bulle vocale pour un ID d'utilisateur donné
    private CreateVoiceBubble(userId: string) {
 
        // Obtenir le socket de tête du personnage de l'utilisateur
        const headSocket = ZepetoPlayers.instance.GetPlayerWithUserId(userId).character.GetSocket(KnowSockets.HEAD_UPPER);
 
        // Instancier le prefab de la bulle de chat vocal à la position du socket de tête
        const instanceBubble = Object.Instantiate(this.voiceChatPrefab, headSocket) as GameObject;
 
        // Ajouter la bulle instanciée à la carte de bulle vocale
        this._voiceBubbleMap.set(userId, instanceBubble);
        instanceBubble.SetActive(false);
    }
 
    LateUpdate() {

        // Vérifier si la carte de bulle vocale est vide et retourner si c'est le cas
        if (this._voiceBubbleMap.size === 0) {
            return;
        }

        // Itérer à travers la carte de bulle vocale et mettre à jour la rotation de chaque GameObject de bulle
        this._voiceBubbleMap.forEach((bubbleObject: GameObject) => {
            // Définir la rotation de l'objet bulle pour correspondre à la rotation du parent de la caméra
            bubbleObject.transform.rotation = ZepetoPlayers.instance.ZepetoCamera.cameraParent.transform.rotation;
        });

    }
 
}
import { GameObject, Object } from 'UnityEngine';
import { KnowSockets, ZepetoPlayers } from 'ZEPETO.Character.Controller'
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import { AudioMode, RoomProperty, VoiceChatController } from 'ZEPETO.Voice.Chat';
 
export default class VoiceChatBubbleController extends ZepetoScriptBehaviour {
 
    // Variable publique GameObject pour stocker le prefab de la bulle de chat vocal
    public voiceChatPrefab: GameObject;
 
    // Carte privée pour stocker les GameObjects associés aux ID d'utilisateur
    private _voiceBubbleMap: Map<string, GameObject> = new Map<string, GameObject>();
 
    Start() {
        // Ajouter des écouteurs d'événements pour le contrôleur de chat vocal
        VoiceChatController.OnInitializedEvent.AddListener(init => this.OnInitialized(init));
        VoiceChatController.OnRoomConnectedEvent.AddListener(connected => this.OnRoomConnected(connected));
        VoiceChatController.OnSpeechDetectedEvent.AddListener((userId, speechDetected) => this.OnSpeechDetected(userId, speechDetected));
    }
 
    // Méthode appelée lorsque le système de chat vocal est initialisé
    private OnInitialized(initialized: boolean) {
        console.log("[VoiceChat] OnInitialized: ");
        this.EnterVoiceChatRoom(1);
    }
 
    // Méthode appelée lorsque la salle de chat vocal est connectée
    private OnRoomConnected(connected: boolean) {
        console.log("[VoiceChat] OnRoomConnected: ");
    }
 
    // Méthode pour entrer dans une salle de chat vocal en fonction de l'index de l'équipe donné
    private EnterVoiceChatRoom(teamIndex: number) {
        console.log("[VoiceChat] EnterVoiceChatRoom");
 
        // Créer un nouvel objet RoomProperty et définir ses propriétés
        let roomProperty = new RoomProperty();
        roomProperty.SetAudioMode(AudioMode.Omnidirectional);
        VoiceChatController.EnterRoom(roomProperty);
    }
 
    // Méthode appelée lorsqu'un discours d'utilisateur est détecté ou non détecté
    private OnSpeechDetected(userId: string, speechDetected: boolean) {
        console.log("[VoiceChat] OnSpeechDetected: " + userId + ", " + speechDetected);
 
        // Vérifier si l'ID d'utilisateur n'est pas dans la carte de bulle vocale et créer une bulle vocale si ce n'est pas le cas
        if (!this._voiceBubbleMap.has(userId)) {
            this.CreateVoiceBubble(userId);
        }
 
        this.SetVoiceBubble(userId, speechDetected);
    }
 
    // Méthode pour définir l'état actif de la bulle vocale pour un ID d'utilisateur donné
    private SetVoiceBubble(userId: string, speechDetected: boolean) {
        const chatBubble = this._voiceBubbleMap.get(userId);
        chatBubble.SetActive(speechDetected);
    }
 
    // Méthode pour créer une bulle vocale pour un ID d'utilisateur donné
    private CreateVoiceBubble(userId: string) {
 
        // Obtenir le socket de tête du personnage de l'utilisateur
        const headSocket = ZepetoPlayers.instance.GetPlayerWithUserId(userId).character.GetSocket(KnowSockets.HEAD_UPPER);
 
        // Instancier le prefab de la bulle de chat vocal à la position du socket de tête
        const instanceBubble = Object.Instantiate(this.voiceChatPrefab, headSocket) as GameObject;
 
        // Ajouter la bulle instanciée à la carte de bulle vocale
        this._voiceBubbleMap.set(userId, instanceBubble);
        instanceBubble.SetActive(false);
    }
 
    LateUpdate() {

        // Vérifier si la carte de bulle vocale est vide et retourner si c'est le cas
        if (this._voiceBubbleMap.size === 0) {
            return;
        }

        // Itérer à travers la carte de bulle vocale et mettre à jour la rotation de chaque GameObject de bulle
        this._voiceBubbleMap.forEach((bubbleObject: GameObject) => {
            // Définir la rotation de l'objet bulle pour correspondre à la rotation du parent de la caméra
            bubbleObject.transform.rotation = ZepetoPlayers.instance.ZepetoCamera.cameraParent.transform.rotation;
        });

    }
 
}
﻿
﻿
Description du code
Lorsque le script est exécuté, il enregistrera des événements sur chaque bouton dans la fonction Start() et les événements OnInitialized, OnRoomConnected et OnSpeechDetected sur le VoiceChatController.
Après OnInitialized(), le bouton de chat vocal sera exposé sur l'écran du joueur lorsqu'il entre dans le monde, et lorsqu'il appuie sur le bouton, EnterVoiceChatRoom() sera exécuté pour entrer dans la salle de chat vocal.
Chaque fois que le joueur active VoiceChat et parle, OnSpeechDetected() est exécuté, et si speechDetected est vrai, l'objet BubbleChat est activé, et s'il est faux, il est désactivé.
La première fois que la fonction OnSpeechDetected() est activée, CreateVoiceBubble() instanciera un GameObject voiceChatPrefab pour flotter au-dessus de la tête du joueur et l'enregistrera comme données de carte dans _voiceBubbleMap.
Nous utilisons LateUpdate() pour mettre à jour la rotation de la bulle de chat vocal à chaque image pour correspondre au CameraParent du monde ZEPETO. Cela garantit que l'image de la bulle de discours fait toujours face à la caméra. Il vérifie d'abord si _voiceBubbleMap est vide, sinon il met à jour la rotation de l'image de la bulle de discours prefab.
﻿
8) Après avoir terminé d'écrire le script, assignez l'entrée VoiceChatPrefab dans l'inspecteur comme le prefab de bulle de discours que vous avez créé à l'ÉTAPE 1.
﻿
﻿
9) Exécutez-le sur mobile via un code QR ou un lien de test et vous devriez voir l'image de la bulle de discours apparaître au-dessus de la tête du personnage chaque fois que le joueur utilise le chat vocal.
﻿
Modulation de la voix
À partir de la version 0.2.1-preview de Voice Chat, vous pouvez moduler la voix de Voice Chat en mode Script.
﻿
﻿
Essayez la modulation vocale en utilisant le guide API et le code d'exemple.
Type de voix (enum)
Valeur
Description
Type00
0
Original
Type01
1
Souris
Type02
2
Oncle
Type03
3
Écho
Type04
4
Voix profonde
Type05
5
Robot
Type06
6
Dialecte
Type07
7
Mégaphone
Type08
8
Bête
Type09
9
Machine
Type10
10
Courant fort
Type11
11
Enfant
Type12
12
Hérisson
﻿
Voici un exemple de script de modulation vocale.
JS
import { Button } from 'UnityEngine.UI';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { RoomProperty, VoiceChatController, VoiceType } from 'ZEPETO.Voice.Chat';

export default class VoiceModulationManager extends ZepetoScriptBehaviour {
 
    // Boutons pour définir différents types de voix
    public buttons: Button[];
 
    Start() {
        const voiceTypes = [
            VoiceType.Type00,
            VoiceType.Type01,
            VoiceType.Type05,
            VoiceType.Type03,
        ];
 
        for (const [index, button] of this.buttons.entries()) {
            button.onClick.AddListener(() => {
                // Définir le type de voix correspondant à l'index du bouton cliqué
                VoiceChatController.SetVoiceType(voiceTypes[index]);
            });
        };
 
        // Méthode appelée lorsque le système de chat vocal est initialisé
        VoiceChatController.OnInitializedEvent.AddListener(
            init => {
                VoiceChatController.EnterRoom(new RoomProperty());;
            }
        );
 
        // Méthode appelée lorsque la salle de chat vocal est connectée
        VoiceChatController.OnRoomConnectedEvent.AddListener(
            connected => {
                // Définir le type de voix initial et activer le retour audio
                VoiceChatController.SetVoiceType(voiceTypes[0]);
                VoiceChatController.EnableLoopback(true);
            }
        );
    }
 
    // Méthode pour quitter la salle de chat vocal
    OnDestroy() {
        VoiceChatController.OnInitializedEvent.RemoveAllListeners();
        VoiceChatController.OnRoomConnectedEvent.RemoveAllListeners();
    }
}
import { Button } from 'UnityEngine.UI';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { RoomProperty, VoiceChatController, VoiceType } from 'ZEPETO.Voice.Chat';

export default class VoiceModulationManager extends ZepetoScriptBehaviour {
 
    // Boutons pour définir différents types de voix
    public buttons: Button[];
 
    Start() {
        const voiceTypes = [
            VoiceType.Type00,
            VoiceType.Type01,
            VoiceType.Type05,
            VoiceType.Type03,
        ];
 
        for (const [index, button] of this.buttons.entries()) {
            button.onClick.AddListener(() => {
                // Définir le type de voix correspondant à l'index du bouton cliqué
                VoiceChatController.SetVoiceType(voiceTypes[index]);
            });
        };
 
        // Méthode appelée lorsque le système de chat vocal est initialisé
        VoiceChatController.OnInitializedEvent.AddListener(
            init => {
                VoiceChatController.EnterRoom(new RoomProperty());;
            }
        );
 
        // Méthode appelée lorsque la salle de chat vocal est connectée
        VoiceChatController.OnRoomConnectedEvent.AddListener(
            connected => {
                // Définir le type de voix initial et activer le retour audio
                VoiceChatController.SetVoiceType(voiceTypes[0]);
                VoiceChatController.EnableLoopback(true);
            }
        );
    }
 
    // Méthode pour quitter la salle de chat vocal
    OnDestroy() {
        VoiceChatController.OnInitializedEvent.RemoveAllListeners();
        VoiceChatController.OnRoomConnectedEvent.RemoveAllListeners();
    }
}
﻿
Description du code :
Ajoute un écouteur onClick pour chaque bouton afin de définir différents types de modulation vocale.
Les éléments du même index dans le boutons tableau et le voiceTypes tableau sont appariés.
Lors de l'entrée dans le monde, VoiceChatController est initialisé, et la connexion à la salle est établie automatiquement.
Le type de modulation vocale initial est défini sur Type00, et le retour audio est activé pour entendre votre propre voix.
Notez que pour l'invocation de SetVoiceType et EnableLoopback, une connexion à la salle est nécessaire. Par conséquent, la configuration initiale est gérée dans l'écouteur de l'OnRoomConnectedEvent.
﻿
﻿
﻿
Changer l'emplacement de lecture audio du joueur local
﻿
Vous pouvez changer l'emplacement du chat vocal du joueur local en utilisant VoiceChatController.SetLocalPlayerTransform().
En utilisant cela, vous pouvez créer divers scénarios en définissant votre emplacement à un espace ou un objet spécifique lors de la conversation en chat vocal.
﻿
📘 conseils
La transformation du chat vocal est liée à la transformation du personnage ZEPETO du joueur local.
Par conséquent, si le personnage ZEPETO du joueur local n'a pas été créé dans le monde, votre voix peut ne pas être transmise.
Dans ce cas, vous pouvez utiliser le chat vocal en définissant l'emplacement de lecture de la voix dans la scène actuelle en utilisant SetLocalPlayerTransform().
﻿
API
Description
public static SetLocalPlayerTransform($transform: UnityEngine.Transform):void
Fonction pour changer la position de lecture audio du joueur local
﻿
❗️ Avertissement
SetLocalPlayerTransform() doit être appelé quelque temps après VoiceChatController.OnInitializedEvent(true) lorsque le chat vocal est initialisé.
﻿
1) Ci-dessous un exemple de script pour la fonction de changement de position de la voix.
VoiceTransformSample
import { GameObject, Transform, Vector3 } from 'UnityEngine';
import { Button } from 'UnityEngine.UI';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { AudioMode, RoomProperty, VoiceChatController } from 'ZEPETO.Voice.Chat';

export default class VoiceTransformSample extends ZepetoScriptBehaviour {

    // Bouton pour définir la transformation de la voix près
    public buttonCloserTransform: Button;

    // Bouton pour définir la transformation de la voix loin
    public buttonFartherTransform: Button;

    // Transformation pour la position de la voix
    private voiceTransform: Transform;

    Start() {

        // Créer un nouvel objet GameObject et assigner la transformation pour stocker l'objet de transformation de la voix
        const voiceTransformObject = new GameObject;  
        this.voiceTransform = voiceTransformObject.transform;

        // Méthode appelée lorsque le système de chat vocal est initialisé
        VoiceChatController.OnInitializedEvent.AddListener(
            init => {
                let roomProperty = new RoomProperty();

                // Définir le mode audio sur audio spatial directionnel 3D
                roomProperty.SetAudioMode(AudioMode.Directional);
                VoiceChatController.EnterRoom(roomProperty);  

                // Définir la transformation de chat vocal pour la voix du joueur local
                VoiceChatController.SetLocalPlayerTransform(this.voiceTransform);
            }
        );
        
        // Définir la position de la transformation de la voix à (0,0,0) lorsque 'buttonCloseTransform' est cliqué
        this.buttonCloserTransform.onClick.AddListener(()=>{
            this.voiceTransform.position = Vector3.zero;
        })
        
        // Définir la position de la transformation de la voix à un point éloigné lorsque 'buttonFarTransform' est cliqué
        this.buttonFartherTransform.onClick.AddListener(()=>{
            this.voiceTransform.position = new Vector3(0,0,-10);
        })

    }

    // Méthode pour quitter la salle de chat vocal
    OnDestroy() {
        VoiceChatController.OnInitializedEvent.RemoveAllListeners();
        VoiceChatController.OnRoomConnectedEvent.RemoveAllListeners();
    }

}
import { GameObject, Transform, Vector3 } from 'UnityEngine';
import { Button } from 'UnityEngine.UI';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { AudioMode, RoomProperty, VoiceChatController } from 'ZEPETO.Voice.Chat';

export default class VoiceTransformSample extends ZepetoScriptBehaviour {

    // Bouton pour définir la transformation de la voix près
    public buttonCloserTransform: Button;

    // Bouton pour définir la transformation de la voix loin
    public buttonFartherTransform: Button;

    // Transformation pour la position de la voix
    private voiceTransform: Transform;

    Start() {

        // Créer un nouvel objet GameObject et assigner la transformation pour stocker l'objet de transformation de la voix
        const voiceTransformObject = new GameObject;  
        this.voiceTransform = voiceTransformObject.transform;

        // Méthode appelée lorsque le système de chat vocal est initialisé
        VoiceChatController.OnInitializedEvent.AddListener(
            init => {
                let roomProperty = new RoomProperty();

                // Définir le mode audio sur audio spatial directionnel 3D
                roomProperty.SetAudioMode(AudioMode.Directional);
                VoiceChatController.EnterRoom(roomProperty);  

                // Définir la transformation de chat vocal pour la voix du joueur local
                VoiceChatController.SetLocalPlayerTransform(this.voiceTransform);
            }
        );
        
        // Définir la position de la transformation de la voix à (0,0,0) lorsque 'buttonCloseTransform' est cliqué
        this.buttonCloserTransform.onClick.AddListener(()=>{
            this.voiceTransform.position = Vector3.zero;
        })
        
        // Définir la position de la transformation de la voix à un point éloigné lorsque 'buttonFarTransform' est cliqué
        this.buttonFartherTransform.onClick.AddListener(()=>{
            this.voiceTransform.position = new Vector3(0,0,-10);
        })

    }

    // Méthode pour quitter la salle de chat vocal
    OnDestroy() {
        VoiceChatController.OnInitializedEvent.RemoveAllListeners();
        VoiceChatController.OnRoomConnectedEvent.RemoveAllListeners();
    }

}
﻿
Description du code
Lorsque la scène commence, créez un objet de jeu appelé voiceTransformObject dans le Start() fonction et enregistrez le Transform dans voiceTransform.
Lorsque le chat vocal OnInitialized est appelé, veuillez appliquer les paramètres suivants :
Définissez le chat vocal en mode audio spatial 3D via SetAudioMode(AudioMode.Directional).
Définissez la position du chat vocal du joueur local sur voiceTransform via VoiceChatController.SetLocalPlayerTransform().
buttonCloserTransform définit la position de voiceTransform à l'origine (0, 0, 0) lorsque le bouton est cliqué.
buttonFartherTransform définit la position de voiceTransform à (10, 0, 0) lorsque le bouton est cliqué.
﻿
2) Enregistrez le bouton sur le Canvas dans la scène pour buttonCloserTransform et buttonFartherTransform du composant VoiceTransformSample.
﻿
﻿
3) Si vous l'exécutez sur votre téléphone mobile en utilisant le code QR ou le lien de test, vous pouvez vérifier ce qui suit.
Lorsque vous appuyez sur le bouton Plus près, votre voix semblera plus proche des autres.
Lorsque vous appuyez sur le bouton Plus loin, votre voix sera entendue de loin par les autres.
﻿
﻿
﻿
API	Description
OnInitializedEvent	Les API de chat vocal sont disponibles après qu'un événement True se soit produit dans l'événement d'initialisation. Si cet événement est True, le chat vocal est disponible, et s'il est False, le chat vocal n'est pas disponible.
EnterRoom(RoomProperty roomProperty)	Fonctions pour entrer dans une salle de chat vocal - Après être entré avec succès dans la salle de chat vocal, le bouton de chat vocal apparaîtra
ExitRoom()	Fonction pour quitter une salle de chat vocal
OnRoomConnectedEvent	Un événement pour vérifier l'état d'entrée dans une salle de chat vocal. Si cet événement est vrai, l'utilisateur est entré dans la salle de chat vocal ; s'il est faux, l'utilisateur a quitté la salle de chat vocal.
OnSpeechDetectedEvent<string, boolean>	Événement pour détecter l'utilisateur qui parle actuellement dans le chat vocal. - string est l'userId de l'utilisateur qui parle - boolean est vrai lorsque l'énoncé commence, faux lorsque l'énoncé se termine
ChangeTeamID(number teamid)	Fonction pour changer le TeamId utilisé dans la salle de chat vocal - Peut seulement être défini sur une valeur int de 1 ou plus
API	Description
SetAudioMode	Mode audio à utiliser dans le chat vocal - AudioMode.Omnidirectionnel: Mode de chat vocal sans atténuation de la voix basée sur la distance (Vous pouvez l'utiliser avec ou sans le personnage ZEPETO) - AudioMode.Directionnel: Mode de chat vocal avec atténuation de la voix basée sur la distance (Le personnage ZEPETO doit être présent dans la scène, car ce mode fonctionne en fonction de l'emplacement du personnage ZEPETO)
SetTeamID	TeamId à utiliser dans le chat vocal pour activer le chat vocal entre les utilisateurs ayant le même TeamId. - Ne peut être défini qu'à une valeur entière de 1 ou plus
Type de voix (enum)	Valeur	Description
Type00	0	Original
Type01	1	Souris
Type02	2	Oncle
Type03	3	Écho
Type04	4	Voix profonde
Type05	5	Robot
Type06	6	Dialecte
Type07	7	Mégaphone
Type08	8	Bête
Type09	9	Machine
Type10	10	Courant fort
Type11	11	Enfant
Type12	12	Hérisson
API	Description
public static SetLocalPlayerTransform($transform: UnityEngine.Transform):void	Fonction pour changer la position de lecture audio du joueur local
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
Personnaliser l'envoi et la réception des messages de chat
Capture d'écran