通过

Party Unity 插件概述

PlayFab Party Unity SDK 插件是在 C# C++ 为方便 Unity 游戏开发人员而创建的本机 Party 库之上的 Unity 包装器。

它使你能够在 Unity 游戏中使用 Party 和 Party 认知服务。 这包括多人游戏网络、聊天消息和数据交换、交叉聊天、交叉播放、实时文本聊天翻译和语音听录服务等辅助功能。 它专为在多个平台上开发游戏而设计。

PlayFab Party Unity 插件与 PlayFab"core"Unity SDK 插件一起使用，该插件提供其他 PlayFab 功能，如经济、排行榜等。 有关详细信息，请参阅PlayFab Unity SDK和 PlayFab Unity SDK 文档。

Party Unity 插件可作为 Unity 资产包下载。 目前支持在以下平台上开发游戏：

“PlayStation”是索尼交互娱乐公司的注册商标或商标。

“PS4”是索尼交互娱乐公司的注册商标或商标。

“PS5”是索尼交互娱乐公司的注册商标或商标。

*- GDK 的基础 Party 库不包括在插件中（请参阅下文）。

“PlayStation”是索尼交互娱乐公司的注册商标或商标。

Party Unity 插件提供了哪些 API 功能？

  • 游戏网络
  • VoIP
  • 支持以下平台：
    • GDK：
      • Xbox 系列 X\|S
      • Xbox One
      • 电脑
    • Windows
    • iOS
    • Android
    • PS4™
    • PS5™
    • Switch
  • 支持上述平台的交叉游戏和交叉对话
  • 群认知服务
    • 实时文本聊天翻译
    • 实时语音聊天翻译
    • 实时语音聊天翻译
    • 文本转语音合成

“PS4”是索尼交互娱乐公司的注册商标或商标。

“PS5”是索尼交互娱乐公司的注册商标或商标。

Party Unity 插件中包含哪些内容？

  • 简化了由 PlayFabMultiplayerManager 类和预制件在 Unity 中编写的顶级 Party API， C# 以便更轻松地将用户的 Unity 游戏与 Party 库的核心功能集成
  • C# 向基础本机 C++ （） Party 库 API 提供托管代码接口的互操作层。 它由顶级 API 使用 C#。
  • C++每个受支持平台的基础本机 （） Party 二进制文件：
    • 适用于 Windows 的群 DLL 库
    • 适用于 iOS 的群 iOS 框架库（设备和模拟器）
    • 适用于 Android 的 Party AAR 库存档
    • 不包括适用于 Microsoft Game Core 的群 DLL 库。 它们使用 GDK 分发，并且必须在生成用户的 Unity 项目之前复制到插件（请参阅插件随附的 README 文件中的详细信息）
    • 适用于 PS4、PS5 群
    • 用于交换机的群静态库
  • PlayFab"core"Unity SDK 插件（可根据需要独立更新）
  • Xbox Live身份验证和策略提供程序 API，目前仅在 GDK 平台上受支持

群 Unity 插件版本和平台之间的兼容性

Party Unity 插件已发布，可在多个分发点（Git 存储库）下载，具体取决于平台。 对某些分发点的访问受到限制，需要向 Microsoft 代表发出请求。

为了更好地指导从不同分发点下载的版本之间的兼容性，并反映对基础本机库的特定版本的引用，Party Unity 插件遵循自定义版本控制方案。

Party Unity 插件版本控制方案

X.X.X.Y-(distribution-point-indicator).Z

例如， 1.5.0.3-main.0 （从主公共 GitHub 存储库下载的版本）或 1.5.0.3-ps5.0 （仅适用于 PS5 的具有 Party 二进制文件的版本，从具有受限访问权限的存储库下载）。

版本组件：

  • X.X.X- 所有受支持平台上基础参与方库的最低版本。 这用于与基础库版本的常规引用一致性 C++。 在上面的示例中，每个平台的包含 Party 库的版本 1.5.0 或更高版本。
  • Y- Party Unity 层中任何修改的增量索引 C# ，适用于版本的任何给定 X.X.X 部分。
  • (distribution-point-indicator)- 用于跟踪从哪个分发点下载特定 Party Unity 插件包的助记码。 它因分发点而异，例如 main （主要公共分发 GitHub 存储库）、 ps5 （Microsoft Azure对 PS5 开发人员具有受限访问权限的 DevOps 存储库），等等。
  • Z- 分发点唯一的任何修改的增量索引（例如，仅针对特定平台更新/修补的参与方二进制文件）。

在任何版本组件中，数字越大，就从左到右而言，表示较新的版本。

来自不同分发点的版本之间的兼容性

无论从哪个分发点下载 Party Unity 插件，它都保证与从任何其他分发点下载的 Party Unity 插件完全兼容，如果 其版本的前四个数字（X.X.X.Y）是相同的。 可以按任何顺序将不同分发点中的兼容版本导入到用户的 Unity 项目中，而不会相互覆盖/中断，因为其共享代码应相同。 尽管每个文件可能具有一些特定于特定平台的附加（非共享）文件，但不应重叠。

例如，如果以 iOS、PS5 和 Switch 为目标，可以按任意顺序在 Unity 项目中导入以下所有版本的 Party Unity 插件：

  • 1.5.0.3-main.0（导入适用于 iOS 的 Party 二进制文件以及其他文件）
  • 1.5.0.3-ps5.0（导入 PS5 的 Party 二进制文件以及其他文件）
  • 1.5.0.3-sw.0（导入用于 Switch 和其他文件的 Party 二进制文件）

每个插件中包含的共享（跨平台）Unity C# 代码将相同。

支持哪些版本的 Unity？

我们努力支持从 Unity 2017 开始的所有最新版本的 Unity，但是你的选择可能因每个特定平台的 Unity 开发加载项的可用性而受限，请参阅相应的 Unity 文档。 这反过来也可能会限制你选择的平台 SDK。 通常，我们使用可用于每个平台的最新版本的 Unity 开发加载项之一测试 Party Unity 插件。 我们鼓励客户报告任何新版本的 Unity 编辑器、Unity 加载项或平台 SDK 的任何生成或运行时问题。

定价

VoIP 和游戏网络功能适用于使用Xbox Live帐户登录的用户（目前仅在 GDK 平台上受支持）。

群认知服务和其他服务可能具有与之相关的费用。 有关详细信息，请参阅 PlayFab 群帐单 或联系 Microsoft 代表。