Convai Player

玩家的 Actor 组件

Convai 玩家 是一个负责捕获麦克风音频并将其流式传输到 Convai 角色的 Actor 组件。

为了在多人游戏中使用语音聊天，此组件必须添加到玩家所控制的对象上，而不是 PlayerController 上。

Convai Player 函数

文本转语音和语音转语音

函数	返回	说明
是否正在录音()	布尔值	返回 True 如果已录制麦克风音频， 假 否则。
是否在说话()	布尔值	如果麦克风音频正在被流式传输，则返回真，否则返回假。
开始录音()	无	开始录制麦克风音频，之后请使用“结束录音”函数。
结束录音()	USoundWave*	停止从麦克风录音，并输出录制的麦克风音频。
发送文本( UConvaiChatbotComponent* ConvaiChatbotComponent, FString Text, UConvaiEnvironment* Environment, bool GenerateActions, bool VoiceResponse, bool RunOnServer, bool UseServerAPI_Key )	无	向角色发送文本。
开始说话( UConvaiChatbotComponent* ConvaiChatbotComponent, UConvaiEnvironment* Environment, bool GenerateActions, bool VoiceResponse, bool RunOnServer, bool StreamPlayerMic, bool UseServerAPI_Key )	无	开始将麦克风音频流式传输给角色。之后请使用“结束说话”函数，让角色知道你正在说话。
结束说话()	无	停止将麦克风音频流式传输给角色。

麦克风设置

函数	返回	说明
获取可用的捕获设备名称()	TArray<FString>	返回所有可用的捕获设备。
获取麦克风音量倍率()	无	获取麦克风音量倍率。
设置捕获设备名称()	布尔值	设置捕获设备名称。
设置麦克风音量倍率()	无	设置麦克风音量倍率。
获取当前捕获设备()	无	获取当前捕获设备的信息。

StartTalking() 和 SendText() 参数

参数	说明
UConvaiChatbotComponent* ConvaiChatbotComponent	要交谈的角色。
UConvaiEnvironment* Environment	包含场景中所有相关对象和角色，包括（玩家），以及角色可执行的所有动作。使用 CreateConvaiEnvironment() 函数来创建，然后使用诸如 AddAction(), AddCharacter(), AddMainCharacter() 来填充它。
FString Text	要发送给角色的文本。
bool GenerateActions	是否生成动作（必须提供且有效的 Environment）
bool VoiceResponse	如果为 true，则会生成语音回复，否则只会生成文本回复。
bool RunOnServer	如果为 true，则该函数会在服务器上运行，这可用于多人会话中，让其他玩家听到角色的语音回复。
bool StreamPlayerMic	如果为 true，则会在多人会话中将玩家的语音流式传输给其他玩家，这与语音聊天效果相同。