PartyLocalChatControl::SetAudioInput

Artikel
08/10/2024

Konfiguriert das bevorzugte Mikrofon oder Aufnahmegerät, das das Chatsteuerelement für die Audioeingabe verwendet.

Syntax

PartyError SetAudioInput(  
    PartyAudioDeviceSelectionType audioDeviceSelectionType,  
    PartyString audioDeviceSelectionContext,  
    void* asyncIdentifier  
)

Parameter

audioDeviceSelectionType PartyAudioDeviceSelectionType

Wenn PartyAudioDeviceSelectionType::None angegeben ist, wird die Audioeingabe gelöscht. Wenn PartyAudioDeviceSelectionType::SystemDefault angegeben ist, versucht die Parteibibliothek, das Standardkommunikationsgerät des Systems zu verwenden. Wenn PartyAudioDeviceSelectionType::P latformUserDefault angegeben ist, versucht die Parteibibliothek, das Standardkommunikationsgerät zu verwenden, das zugeordnet audioDeviceSelectionContextist. Wenn PartyAudioDeviceSelectionType::Manual angegeben ist, versucht die Parteibibliothek, das Kommunikationsgerät zu verwenden, dessen Geräte-ID übereinstimmt. Beachten Sie, dass PartyAudioDeviceSelectionType::Manual unter Android, iOS oder macOS nicht unterstützt wird.

audioDeviceSelectionContext PartyString
Optional

Bei Verwendung von PartyAudioDeviceSelectionType::None oder PartyAudioDeviceSelectionType::SystemDefaultaudioDeviceSelectionContext wird ignoriert. Bei Verwendung von PartyAudioDeviceSelectionType::P latformUserDefaultaudioDeviceSelectionContext muss der nicht NULL-, nicht leere plattformspezifische Benutzerkontext sein, den das Chat-Steuerelement bei der Auswahl des Audiogeräts verwenden sollte. Bei Verwendung von PartyAudioDeviceSelectionType::ManualaudioDeviceSelectionContext muss der Nicht-NULL-Bezeichner des Audiogeräts sein, das vom Chatsteuerelement verwendet werden soll.

asyncIdentifier Leere*
Optional

Ein optionaler, app-definierter Kontextwert in Zeigergröße, der verwendet werden kann, um die Änderung des Abschlusszustands diesem Aufruf zuzuordnen.

Rückgabewert

PartyError

c_partyErrorSuccess , wenn der asynchrone Vorgang zum Festlegen der Audioeingabe gestartet wurde, oder andernfalls ein Fehlercode. Wenn bei dieser Methode ein Fehler auftritt, werden keine zugehörigen Zustandsänderungen generiert. Die lesbare Form des Fehlercodes kann über PartyManager::GetErrorMessage() abgerufen werden.

Hinweise

Diese Methode stellt einen asynchronen Vorgang in die Warteschlange, um das bevorzugte Aufzeichnungsgerät zu konfigurieren, das diesem lokalen Chatsteuerelement zugeordnet ist. Wenn die Methode erfolgreich ist, wird ein PartyLocalChatAudioInputChangedStateChange von PartyManager::StartProcessingStateChanges() mit Details zum Eingabegerät status bereitgestellt, und nach Abschluss des Vorgangs wird ein PartySetChatAudioInputCompletedStateChange bereitgestellt, der auf Erfolg oder Fehler hinweist. Nach Abschluss des Vorgangs wird jedes Mal ein zusätzlicher PartyLocalChatAudioInputChangedStateChange bereitgestellt, wenn sich das Audiogerät status, z. B. aufgrund von Geräteentfernungen.

Wenn das angegebene Gerät nicht vorhanden ist, abonniert das Chat-Steuerelement Audiogeräteänderungen und verwendet das Gerät, wenn es angezeigt wird.

Wenn Sie die PlatformUserDefault Option auf der Xbox-Plattform verwenden, muss die Xbox-Benutzer-ID (XUID) als audioDeviceSelectionContext Wert übergeben werden.

Voraussetzungen

Header: Party.h

Weitere Informationen

PartyLocalChatControl
PartyLocalChatControl::GetAudioInput
PartyLocalChatControl::SetAudioOutput

Freigeben über