VoiceChatService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
VoiceChatService est responsable de la fonctionnalité de haut niveau du chat avec voix.Cela se compose principalement d'options de configuration et de fonctions qui ne sont pas spécifiquement contrôlées par des instances plus spécifiques.
Résumé
Propriétés
Détermine la courbe d'atténuation de distance que l'installation par défaut de chat vocal utilise lorsque AudioDeviceInput et AudioEmitter objets sont générés.
Contrôle si chaque joueur éligible à la voix peut être entendu comme s'il parlait à travers son personnage.
Contrôle si le chat vocal est représenté et contrôlé par AudioDeviceInput objets.
Méthodes
Renvoie si l'utilisateur donné a ou non la voix activée.
Propriétés
DefaultDistanceAttenuation
Cette propriété contrôle la courbe de réduction de distance par défaut attribuée à toutes les instances générées AudioEmitter dans la configuration par défaut de chat vocal.
Cette propriété n'a d'effet que si EnableDefaultVoice et UseAudioApi sont tous deux activés, puisque aucun AudioEmitters n'est autrement généré.
EnableDefaultVoice
Lorsqu'il est activé, chaque joueur éligible peut être entendu comme s'il parlait à travers son personnage.Les détails de la mise en œuvre de la configuration de la voix dépendent de UseAudioApi.
Lorsque UseAudioApi est Enabled, la désactivation de cette propriété désactive la configuration par défaut, mais AudioDeviceInput fonctionnera toujours.Inversement, lorsque UseAudioApi est Disabled, la désactivation de la configuration par défaut de la voix désactive efficacement le chat vocal tout entier.
UseAudioApi
Si Enabled , la configuration du chat vocal est représentée et contrôlée par AudioDeviceInput objets. Plus précisément :
- Un AudioDeviceInput sera créé et parenté à chaque voix éligible Player.
- Un AudioEmitter sera créé et parenté à chaque joueur éligible à la voix Player.Character.
- Un AudioListener sera créé et parenté à Workspace.CurrentCamera.
Vous pouvez désactiver le paramètre par défaut en définissant VoiceChatService.EnableDefaultVoice à false.
Si Disabled , la configuration du chat vocal est effectuée via un système interne uniquement.
Actuellement, définir ceci à Automatic a le même sens que Disabled .Cependant, à l'avenir, Automatic deviendra Enabled afin que de nouvelles expériences puissent atteindre une plus grande personnalisation sur la voix.
Méthodes
IsVoiceEnabledForUserIdAsync
Renvoie si l'utilisateur donné a ou non la voix activée.Du côté du client, cela ne peut être utilisé que pour vérifier l'état vocal du joueur local.Du côté du serveur, cela ne peut vérifier le statut de la voix que pour les joueurs sur ce serveur.
Cette fonction peut lancer une erreur si l'appel HTTP échoue.
local Players = game:GetService("Players")
local VoiceChatService = game:GetService("VoiceChatService")
local localPlayer = Players.LocalPlayer
local success, enabled = pcall(function()
return VoiceChatService:IsVoiceEnabledForUserIdAsync(localPlayer.UserId)
end)
if success and enabled then
print("Voice chat enabled!")
end
Paramètres
Le Player.UserId à vérifier.
Retours
Si cet utilisateur a la voix activée.