Passer au contenu principal
Configure le haut-parleur ou casque préféré que le contrôle de chat utilisera comme sortie audio.

Syntaxe

Paramètres

audioDeviceSelectionType   PartyAudioDeviceSelectionType Si PartyAudioDeviceSelectionType::None est spécifié, la sortie audio est effacée. Si PartyAudioDeviceSelectionType::SystemDefault est spécifié, la bibliothèque Party tente d’utiliser le périphérique de communication par défaut du système. Si PartyAudioDeviceSelectionType::PlatformUserDefault est spécifié, la bibliothèque Party tente d’utiliser le périphérique de communication par défaut associé à audioDeviceSelectionContext. Si PartyAudioDeviceSelectionType::Manual est spécifié, la bibliothèque Party tente d’utiliser le périphérique de communication dont l’identificateur correspond à audioDeviceSelectionContext. audioDeviceSelectionContext   PartyString
optional
Avec PartyAudioDeviceSelectionType::None ou PartyAudioDeviceSelectionType::SystemDefault, audioDeviceSelectionContext est ignoré. Avec PartyAudioDeviceSelectionType::PlatformUserDefault, audioDeviceSelectionContext doit être le contexte utilisateur propre à la plateforme, non null et non vide, que le contrôle de chat doit utiliser lors de la sélection du périphérique audio. Avec PartyAudioDeviceSelectionType::Manual, audioDeviceSelectionContext doit être l’identificateur, non null et non vide, du périphérique audio que le contrôle de chat doit utiliser. asyncIdentifier   void*
optional
Une valeur de contexte facultative de la taille d’un pointeur, définie par l’application, qui peut être utilisée pour associer le changement d’état de fin à cet appel.

Valeur renvoyée

PartyError c_partyErrorSuccess si l’opération asynchrone de définition de la sortie audio a commencé ; sinon, un code d’erreur. Si cette méthode échoue, aucun changement d’état associé n’est généré. La forme lisible du code d’erreur peut être obtenue via PartyManager::GetErrorMessage().

Remarques

Cette méthode met en file d’attente une opération asynchrone pour configurer le haut-parleur ou casque préféré associé à ce contrôle de chat local. Si la méthode réussit, un PartyLocalChatAudioOutputChangedStateChange est fourni par PartyManager::StartProcessingStateChanges() avec des détails sur l’état du périphérique de sortie, et un PartySetChatAudioOutputCompletedStateChange est fourni à la fin de l’opération pour indiquer la réussite ou l’échec. Après la fin de l’opération, un PartyLocalChatAudioOutputChangedStateChange supplémentaire est fourni chaque fois que l’état du périphérique audio change, par exemple en raison de la suppression d’un périphérique.

Si le périphérique spécifié n’est pas présent, le contrôle de chat s’abonne aux modifications des périphériques audio et utilise le périphérique lorsqu’il apparaît.

Lors de l’utilisation de l’option PlatformUserDefault sur la plateforme XBOX, l’identificateur d’utilisateur XBOX (XUID) doit être transmis comme valeur de audioDeviceSelectionContext.

Configuration requise

En-tête : Party.h

Voir aussi

PartyLocalChatControl
PartyLocalChatControl::GetAudioOutput
PartyLocalChatControl::SetAudioInput
Dernière modification le 8 octobre 2026