Syntaxe
Paramètres
audioDeviceSelectionType PartyAudioDeviceSelectionType
Si PartyAudioDeviceSelectionType::None est spécifié, l’entrée 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. Notez que PartyAudioDeviceSelectionType::Manual n’est pas pris en charge sur Android, iOS ni macOS.
audioDeviceSelectionContext PartyStringoptional 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
PartyErrorc_partyErrorSuccess si l’opération asynchrone de définition de l’entrée 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 périphérique d’enregistrement préféré associé à ce contrôle de chat local. Si la méthode réussit, un PartyLocalChatAudioInputChangedStateChange est fourni par PartyManager::StartProcessingStateChanges() avec des détails sur l’état du périphérique d’entrée, et un PartySetChatAudioInputCompletedStateChange 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 PartyLocalChatAudioInputChangedStateChange 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.hVoir aussi
PartyLocalChatControlPartyLocalChatControl::GetAudioInput
PartyLocalChatControl::SetAudioOutput