Dépannage du clavardage vocal

Si deux joueurs tentent de clavarder ensemble et que l’un d’eux ou les deux ne s’entendent pas, essayez les étapes de dépannage suivantes.

Vérifier les indicateurs de clavardage

Les indicateurs de clavardage de PlayFab Party peuvent servir à dépanner les problèmes audio. Utilisez PartyLocalChatControl::GetLocalChatIndicator() pour inspecter l’état audio instantané du contrôle de clavardage local. Un contrôle de clavardage en bon état devrait retourner PartyLocalChatControlChatIndicator::Silent ou PartyLocalChatControlChatIndicator::Talking, selon que la bibliothèque détecte ou non de la voix provenant de l’entrée du microphone.

Si PartyLocalChatControlChatIndicator::AudioInputMuted est retourné, le flux audio sortant du contrôle de clavardage a été mis en sourdine précédemment au moyen d’un appel à PartyLocalChatControl::SetAudioInputMuted(true), et la sourdine doit être désactivée en appelant PartyLocalChatControl::SetAudioInputMuted(false)
Si PartyLocalChatControlChatIndicator::NoAudioInput est retourné, soit l’entrée audio du contrôle de clavardage local n’a jamais été définie en appelant PartyLocalChatControl::SetAudioInputMuted(), soit l’initialisation de l’entrée audio a échoué. Passez à la section suivante pour obtenir des conseils sur le diagnostic des échecs d’initialisation de l’entrée audio.

Utilisez PartyLocalChatControl::GetChatIndicator() pour inspecter l’état de l’entrée audio d’un contrôle de clavardage distant, par rapport à un contrôle de clavardage local.

Si PartyChatControlChatIndicator::Silent est retourné alors que vous vous attendiez à entendre du son, cela peut signifier qu’il y a un problème avec le périphérique audio distant ou que les autorisations de clavardage sur l’appareil distant ne sont pas configurées pour envoyer de l’audio à ce contrôle de clavardage. Passez à la section suivante si cela ressemble à ce que vous vivez.
Si PartyChatControlChatIndicator::Talking est retourné, mais que vous n’entendez toujours aucun son, il peut y avoir un problème avec le périphérique de sortie audio local. Passez à la section suivante pour savoir comment vérifier si un périphérique audio est en bon état.
Si PartyChatControlChatIndicator::IncomingVoiceDisabled est retourné, cela signifie que les autorisations de clavardage du contrôle de clavardage local n’ont pas été configurées pour autoriser l’audio provenant du contrôle de clavardage distant. Passez à la section sur les autorisations de clavardage.
Si PartyChatControlChatIndicator::IncomingCommunicationsMuted est retourné, cela signifie que l’audio entrant a été mis en sourdine au moyen d’un appel précédent à PartyLocalChatControl::SetIncomingAudioMuted(). Appelez PartyLocalChatControl::SetIncomingAudioMuted() pour réactiver le son du contrôle de clavardage distant.

Vérifier que le périphérique audio est bien initialisé

Peu après avoir appelé PartyLocalChatControl::SetAudioInput() ou PartyLocalChatControl::SetAudioOutput(), vous recevrez un PartyLocalChatAudioInputChangedStateChange ou un PartyLocalChatAudioOutputChangedStateChange. Ces deux changements d’état contiennent des renseignements qui peuvent vous aider à résoudre tout problème lié aux périphériques audio. Ces changements d’état contiennent un champ PartyAudioInputState et un champ PartyAudioOutputState qui vous renseignent sur l’état du périphérique audio. Si l’état du périphérique audio est autre que Initialized, cela signifie que PlayFab Party n’a pas pu utiliser le périphérique audio souhaité. Le champ errorDetail du changement d’état peut également servir à obtenir plus de renseignements sur la situation. Appelez PartyManager::GetErrorMessage() pour obtenir une forme lisible du détail de l’erreur.

Par défaut, les contrôles de clavardage ne sont associés à aucun périphérique audio. Assurez-vous d’appeler PartyLocalChatControl::SetAudioInput() et PartyLocalChatControl::SetAudioOutput() sur tous vos contrôles de clavardage.

Vérifier que les contrôles de clavardage disposent des bonnes autorisations de clavardage

Utilisez PartyLocalChatControl::GetPermissions() pour consulter les PartyChatPermissionOptions entre deux contrôles de clavardage. Par exemple, si une utilisatrice Alice n’entend pas un autre utilisateur, Bob, vous devez vous assurer qu’Alice a l’autorisation de recevoir l’audio de Bob et que Bob a l’autorisation d’envoyer de l’audio à Alice. Sur l’appareil d’Alice :

PartyChatPermissionOptions chatPermissions;
PartyError error = localChatControlAlice->GetPermissions(remoteChatControlBob, &chatPermissions);
if (PARTY_SUCCEEDED(error))
{
    if (static_cast<bool>(chatPermissions & PartyChatPermissionOptions::ReceiveAudio))
    {
        printf("Alice can receive audio from Bob!");
    }
}

Sur l’appareil de Bob :

PartyChatPermissionOptions chatPermissions;
PartyError error = localChatControlBob->GetPermissions(remoteChatControlAlice, &chatPermissions);
if (PARTY_SUCCEEDED(error))
{
    if (static_cast<bool>(chatPermissions & PartyChatPermissionOptions::SendAudio))
    {
        printf("Bob can send audio to Alice!");
    }
}

Vérifier le périphérique par défaut par rapport au périphérique de communication par défaut dans Windows

Une source fréquente de confusion concernant l’audio sous Windows porte sur les concepts de périphérique par défaut et de périphérique de communication par défaut. Windows prend en charge ces deux concepts, et il peut s’agir de périphériques différents. Par conception, PlayFab Party utilise le périphérique de communication par défaut dans la version Windows de la bibliothèque lorsque AudioDeviceSelectionType::SystemDefault est passé à PartyLocalChatControl::SetAudioInput ou à PartyLocalChatControl::SetAudioOutput. Le dépannage et les tests doivent toujours être effectués par rapport au périphérique de communication par défaut.

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Vérifier les indicateurs de clavardage

Vérifier que le périphérique audio est bien initialisé

Vérifier que les contrôles de clavardage disposent des bonnes autorisations de clavardage

Vérifier le périphérique par défaut par rapport au périphérique de communication par défaut dans Windows

​Vérifier les indicateurs de clavardage

​Vérifier que le périphérique audio est bien initialisé

​Vérifier que les contrôles de clavardage disposent des bonnes autorisations de clavardage

​Vérifier le périphérique par défaut par rapport au périphérique de communication par défaut dans Windows

Vérifier les indicateurs de clavardage

Vérifier que le périphérique audio est bien initialisé

Vérifier que les contrôles de clavardage disposent des bonnes autorisations de clavardage

Vérifier le périphérique par défaut par rapport au périphérique de communication par défaut dans Windows