Play to Device

Play to Device功能极大地改善了迭代和调试工作流程，您可以：

  • 在visionOS模拟器或Apple Vision Pro设备上通过Unity编辑器有效地迭代和实时预览您的内容
  • 无需重新构建Xcode项目即可部署您的内容
  • 在visionOS模拟器和Apple Vision Pro设备上访问Unity编辑器的播放模式功能

此功能通过Play to Device Host应用程序提供，该应用程序可以安装在visionOS模拟器或Apple Vision Pro设备上。当 Play to Device 主机运行时，您可以在Unity编辑器中按Play，然后查看由 RealityKit 渲染的内容出现在模拟器或设备上。无需中间构建。

您在Unity编辑器中所做的任何更改（例如创建GameObject、修改检查器值、更新和重新编译着色器图等）都将实时同步到模拟器/设备，并且您在主机上执行的任何交互都将同步回到编辑器。

Note: 在运行时加载场景目前不支持Play to Device。

要求

根据您运行应用程序的方式，您需要在visionOS模拟器或Apple Vision Pro设备上安装Play to Device Host。

  • 为了在visionos模拟器上运行Play to Device Host，你可以在Following link中找到Xcode .app文件。
  • 要在_Apple Vision Pro设备上运行Play to Device Host，您可以在Following link中找到TestFlight链接。

It is important to note that the Play to Device Host must match your PolySpatial package version exactly.请参阅Requirements page，了解有关支持的特定编辑器版本的更多信息，具体取决于您正在运行的PolySpatial软件包版本。

首次设置-visionOS模拟器

要安装visionOS模拟器的主机应用程序：

  1. 将“PlayToDeviceHost.app.zip”下载到您的Apple Silicon Mac。请参阅上面的兼容性表，根据您的 PolySpatial 版本确定正确的版本。
  2. 解压zip文件，在Finder中显示“PlayToDeviceHost.app”。
  3. 启动visionOS模拟器，可以在Xcode中转到“Xcode > Open Developer Tool > Simulator”，或者使用Spotlight（命令+空格）并输入“simulator”。
  4. 当模拟器运行时，您可以看到带有各种应用程序图标的主屏幕。将“PlayToDeviceHost.app”从Finder窗口拖到模拟器窗口中。
  5. 几秒钟后，您应该会看到“PlayToDeviceHost”作为应用程序图标之一出现在主屏幕上。请注意，您可能需要滚动应用程序列表才能看到该图标。

首次设置-visionOS硬件

要为Apple Vision Pro设备安装主机应用程序，请执行以下操作：

  1. 在电脑或智能手机上（或在设备上的Safari中）点击TestFlight邀请链接。您应该会看到一个邀请代码。请参阅上面的Compatibility Matrix访问与您的PolySpatial版本兼容的链接。
  2. 在您的Vision Pro设备上打开TestFlight应用程序，必要时登录您的Apple帐户。
  3. 在TestFlight应用程序中点击“Redeem Code”。
  4. 点击邀请链接后，输入您在浏览器中看到的代码。
  5. 阅读构建信息和发布说明后，点击TestFlight应用程序中的“Download”。
  6. 几秒钟后，从TestFlight点击“Open”，或者导航到现在出现在主屏幕上的Play to Device Host应用程序。

首次设置 -Unity编辑器

为设备或模拟器安装主机应用程序后（见上文）：

  1. 在您的设备或Apple VisionOS模拟器中启动PlayToDeviceHost应用程序。
  2. 在Unity编辑器中，通过\ Window > PolySpatial > Play to Device下的主菜单打开Play to Device编辑器窗口。
  3. 如果Play to Device主机应用程序运行在与Unity Editor共享同一LAN的设备上（或在同一台机器上本地运行），则会自动检测到其连接，您可以跳到步骤4。否则，请按照以下步骤添加直接连接：
    1. 打开Advanced Settings折叠页中的Direct Connection部分。
    2. 设置一个唯一标识主机应用程序的Host Name。
    3. 插入映射到步骤1启动的主机应用程序的IP地址和端口。
    4. 点击Add Device按钮。
  4. 通过检查Available Connections列表中的Connect开关来选择要连接的主机应用程序。
  5. 确保Connect on Play 已enabled。
  6. 在Unity编辑器中进入Play mode。Unity编辑器将连接到主机，并开始实时流式传输您的体验到主机。然后，您可以通过编辑器或设备查看、播放或与您的体验进行交互；更改和交互将自动保持同步。

如果您发现连接超时，您可以在Play To Device编辑器窗口的Advanced Settings中增加连接超时。默认超时时间为5秒。

Play To Device Window

Note: 如果一次选择多个连接，内容将同时流式传输到所有选定的主机。

后续使用

初始设置后，每次按下播放按钮时，只要Connect on Play处于enabled状态，并且主机仍处于活动状态，您的内容就会同步到主机应用程序。

故障排除

有关故障排除问题，请参阅常见问题解答中的Play to Device troubleshooting section in the FAQ

＃教程：预览立方体

要在Play To Device主机中预览应用程序，请执行以下操作：

  1. 通过右键单击项目视图并选择Create > PolySpatial > Volume Camera Configuration来创建新的体积摄像机配置资源。

VolCamConfig

Note:确保“Volume Camera Configuration”资源位于“Resources”文件夹中。

  1. 将创建的体积摄像机配置_mode_设置为Bounded

VolVamConfigMode

  1. 在一个新的空场景中，创建一个空GameObject，向其中添加一个体积摄像机组件，并将体积摄像机配置设置为刚刚创建的配置。

VolCamSetup

  1. 在场景中创建一个小立方体并将其放置在体积摄像机边界内。

CubeSetup

  1. 在visionOS模拟器或Vision Pro设备中打开Play To Device主机。

PlayToDeviceApp

  1. 打开Play To Device _Editor Window，并确保已启用Connect on Play。当不再向Play To Device发送数据流并返回游戏视图时，只需关闭Play To Device编辑器窗口或禁用Connect on Play属性。

  2. 打开Play To Device主机后，单击编辑器中的Play按钮。应用程序应该开始在编辑器和主机应用程序中运行。

PlayToDeviceStream

升级/降级PlayToDevice的TestFlight版本

如上所述，您必须使用与编辑器中使用的PolySpatial软件包版本相匹配的Play to Device Host应用程序版本。这说明您可能需要根据项目中PolySpatial的版本升级/降级设备上的应用程序版本。首次使用该链接安装应用程序时，将安装最新版本。

  • 要升级到最新版本，只需打开TestFlight应用程序，在列表中找到“Unity Play to Device Host”，然后点击“Upgrade”。
  • 要降级或升级到最新版本以外的任何版本，点击“Unity Play to Device Host”应用程序的标题。这将为您带来包含更多信息的新视图。
    • 在应用程序详细信息视图中，点击“Previous Builds”
    • 点击与项目中PolySpatial版本相对应的版本号
    • 在构建详细信息视图中，点击“Install”

有关TestFlight和如何测试以前版本的更多信息，请参阅official documentation。