通过

PartyLocalChatControl::SetAudioInput

  • 项目

配置聊天控件将用于音频输入的首选麦克风或录制设备。

语法

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

参数

audioDeviceSelectionType PartyAudioDeviceSelectionType

如果 PartyAudioDeviceSelectionType：：无指定 ，则将清除音频输入。 如果 PartyAudioDeviceSelectionType：：SystemDefault ，则群库将尝试使用系统的默认通信设备。 如果 PartyAudioDeviceSelectionType：:P formUserDefault ，则群库将尝试使用与 audioDeviceSelectionContext相关联的默认通信设备。 如果指定了 PartyAudioDeviceSelectionType：：Manual ，则 Party 库将尝试使用其设备标识符匹配的通信设备。 请注意，Android、iOS 或 macOS 不支持 PartyAudioDeviceSelectionType::Manual。

audioDeviceSelectionContext PartyString
可选

使用PartyAudioDeviceSelectionType::None 或 PartyAudioDeviceSelectionType：：SystemDefault， audioDeviceSelectionContext 将被忽略。 使用 PartyAudioDeviceSelectionType：:P formUserDefault时， audioDeviceSelectionContext 必须是非空的，和非空平台特定用户上下文，聊天控件在选择音频设备时应该使用。 使用 PartyAudioDeviceSelectionType：：Manual， audioDeviceSelectionContext 必须为聊天控件应使用的音频设备的非空标识符。

asyncIdentifier void*
可选

一个可选应用定义的指针大小的上下文值，可用于将完成状态更改与此调用关联起来。

返回值

PartyError

如果用于设置音频输入的异步操作已开始，则为 c_partyErrorSuccess，否则为错误代码。 如果此方法失败，则不会生成任何相关的状态更改。 可通过 PartyManager::GetErrorMessage() 检索错误代码的可读形式。

备注

此方法将异步操作排入队列，以配置与此本地聊天控件关联的首选录制设备。 如果方法成功，PartyManager：：StartProcessingStateChanges（）将提供 PartyLocalChatAudioInputChangedStateChange，并在操作完成后提供PartySetChatAudioInputCompletedStateChange，指示成功或失败。 完成后，每次音频设备状态更改（例如由于设备删除）时，都会提供其他 PartyLocalChatAudioInputChangedStateChange。

如果指定的设备不存在，聊天控件将订阅音频设备更改，并使用该设备（若显示）。

在 Xbox 平台上使用 PlatformUserDefault 选项时，Xbox 用户标识符 (XUID) 必须作为 audioDeviceSelectionContext 值传递。

要求

标题： Party.h

另请参阅

PartyLocalChatControl
PartyLocalChatControl::GetAudioInput
PartyLocalChatControl::SetAudioOutput