认知服务简介

PlayFab Party 认知服务接口包括允许配置和使用 PlayFab Party 提供的辅助功能的函数。

这些功能包括:

  • 实时文本聊天翻译
  • 实时语音聊天翻译
  • 实时语音聊天转写翻译
  • 文本转语音合成

定价

除了核心 VOIP 和游戏网络功能之外,认知服务和其他服务可能具有相关成本。 有关更多详细信息,请访问 PlayFab 群计费页面,或与 Microsoft 代表联系。

使用认知服务接口

若要在游戏中使用认知服务接口,请将以下代码块添加到游戏的 Build.cs 文件。

if (Target.bGenerateProjectFiles || (Target.Type != TargetType.Game && Target.Type != TargetType.Client))
{
	PublicDefinitions.Add("WITH_OSS_PLAYFAB_COGNITIVESERVICES=0");
}
else
{
	PublicDefinitions.Add("WITH_OSS_PLAYFAB_COGNITIVESERVICES=1");

	PublicDependencyModuleNames.Add("OnlineSubsystemPlayFab");
	PrivateDependencyModuleNames.Add("HTTP");
}

此外,可以使用 #if WITH_OSS_PLAYFAB_COGNITIVESERVICES 包装任何游戏代码,以防止在不使用认知服务的平台上出现编译错误。

SetTextChatTranslationOptions

SetTextChatTranslationOptions 允许打开或关闭聊天翻译。

SetVoiceChatTranscriptionOptions

启用和配置语音听录需要 SetVoiceChatTranscriptionOptions。

  • bTranscribeSelf - 将生成本地聊天控件的听录并将其提供给同一本地聊天控件
  • bTranscribeOtherChatControlsWithMatchingLanguages - 将生成与本地聊天控件语言相同的其他聊天控件的听录,并将其提供给本地聊天控件
  • bTranscribeOtherChatControlsWithNonMatchingLanguages - 将生成具有不同于本地聊天控件语言的其他聊天控件的听录,并将其提供给本地聊天控件
  • bTranslateToLocalLanguage - 听录将转换为本地聊天控件的语言

SetTextToSpeechOptions

启用和配置文本到语音时需要 SetTextToSpeechOptions。

  • ETextToSpeechType::Narration - 将音频呈现到本地聊天控件的音频输出
  • ETextToSpeechType::VoiceChat - 将音频呈现到本地聊天控件配置为向其发送音频的聊天控件

SendTextAsVoice

生成发送到连接到 PlayFab Party 网络的所有其他客户端的文本到语音音频。 在调用 SendTextAsVoice之前,必须通过调用 SetTextToSpeechOptions启用文本即语音

SendChatText

将聊天文本字符串发送到连接到 PlayFab Party 网络的所有其他客户端。