三星 Gear VR 调试

本页面的内容:

在目标设备上对项目进行调试十分重要,可对性能问题和其他可能存在的严重问题进行追踪。 以下章节将讲述 Gear VR 项目的调试工具,以及它们的使用方法。

启用 Gear VR 开发者模式

不使用头戴显示器查看 Gear VR 项目便于访问诸如虚幻引擎控制台之类的功能,大大缩短问题的修复时间。 以下部分将说明如何设置 Gear VR 项目,以便脱离头戴显示器进行查看。

执行设置前,须在拥有设备签名的手机上安装 Gear VR 应用程序。 其可为任意类型,下载或编译应用程序均可。

  1. 首先,前往三星 Galaxy Note 4 智能手机的 Settings > Application Manager > Gear VR Service

    T_GearVR_Dev_Mode_01.png

  2. 之后点击 Manage Storage 选项。

    T_GearVR_Dev_Mode_02.png

  3. 然后在 VR Service Version 上进行 6 次点击。

    T_GearVR_Dev_Mode_03.png

  4. 操作完成后将开始扫描过程,完成后即可在屏幕上看到已启用的 Developer Mode

    T_GearVR_Dev_Mode_04.png

  5. 现在即可脱离头戴显示器运行并显示 Gear VR 项目。

    请注意:启用 VR 开发者模式后将对设置进行覆写,在不使用时将头戴显示器关闭,因此手机电量消耗极大。

  6. 如需禁用 VR 开发者模式,将 Developer Mode 滑条从 On 滑动至 Off 即可。

启用 UE4 控制台

UE4 控制台是一个非常强大的工具,可用于查看 UE4 中当前显示的数据,在某些情况下可对这些数据产生影响。 在移动设备上访问 UE4 控制台的方法和在电脑上访问有些许不同,详细说明如下。

在电脑上访问时,在控制台中输入 DumpConsoleCommands,虚幻引擎将在控制台中列出所有可用的控制台命令。

  1. 首先在手机上启用 Gear VR 开发者模式。 之后即可脱离 Gear VR 头戴显示器运行并查看项目。如使用头戴显示器,则无法对手机屏幕进行触控操作。

    T_GearVR_Dev_Mode_04.png

  2. 接下来点击项目图表运行 Gear VR 项目。 运行项目后,即可在手机上看到类似下图的效果。

    T_App_On_Phone.png

  3. Gear VR 项目运行时,用 四根 手指同时点击屏幕即可打开虚幻引擎控制台。 如操作完成,手机屏幕上将出现下图中的输入框。

    T_GearR_Open_Console.png

  4. 在输入框中输入希望执行的控制台命令,然后点击 Ok。 在此例中我们将使用 Stat Memory 命令,确定项目使用的内存量。

    T_GearR_Input_Command.png

  5. 按下 Ok 键后,即可显示当前使用的内存量以及内存使用的出处。

    T_GearR_Displaying_Memory.png

  6. 调试完成后(或需要清除屏幕上的调试信息),输入 Stat None 即可清除屏幕上所有的调试信息。

    进行 Gear VR 头戴显示器控制台调试的最佳选择是蓝牙键盘。无需从头戴显示器移除手机即可使用控制台。

查看 Gear VR 调试日志

开发任意类型的 3D 项目时,调试日志的查看至关重要。 调试日志中包含错误的重要信息和深入分析,在某些情况下甚至还可以提供修复建议。 以下部分将说明如何获取智能手机的调试日志。

在 Android 官方文档中可查看 Logcat 的详细使用信息。

  1. 首先将安装有需要获取调试信息应用程序的智能手机通过 USB 插入电脑。

  2. 按下 Windows 键 + R 键 打开 Windows 命令窗口,在打开的 Run 对话框中输入 CMD。 然后按下键盘上的 Enter 键或用鼠标点击 OK 键。

    T_Open_CMD_Prompt.png

  3. 按下 OK 键后便会出现类似下图的 Windows 命令行窗口。

    T_Windows_CMD.png

  4. 在命令行窗口中输入 ADB Devices,然后按下 Enter 键显示连接到电脑的设备,确定电脑已正常识别智能手机。

    T_Windows_ADB_Devices.png

    如输入 ADB Devices 后为未看到任何内容,请确认 三星 Gear VR 开发 设置部分已完成、列出的所有内容均已安装/设置完成,然后再次尝试输入命令的操作。

  5. 确认可在 ADB Devices 中看到智能手机后,即可开始获取日志信息。 但首先需要清除日志缓存,以便剔除之前的调试信息,只提取当前的调试信息。 输入以下命令即可清除日志。

    adb logcat -c

    T_ADB_Clear_Log.png

  6. 旧日志数据清理完成后,在智能手机上运行应用程序,输入下列命令获取日志信息。

    adb logcat -s UE4 OVR VrApi VrLib VRSVC HmdInfo >logoutput.txt

    T_ADB_Get_Log.png

    如需即时查看输出的日志,省去命令行中的 >logoutput.txt 部分即可在命令行窗口中显示所有日志更新。

  7. 按下键盘上的 CTRL 键 + C 键 即可完成日志获取,日志文件名为 logoutput.txt,保存在 Windows 的 Users 文件夹中。 T_ADB_Log_Location.png

    在打开的命令窗口中运行 ADB logcat 命令后,数据将继续输出到日志文件中。按下 CTRL 键 + C 键 后将停止对日志文件的数据写入。

  8. 在 logcat 命令中添加 UE4OVRVrApiVrLibVRSVCHmdInfo 后,可将这些信息生成到日志文件中。 在创建好的日志文件中搜索条目之一即可找到与其相关的所有调试信息。 在下图的搜索范例中,OVR、UE4、Vrapi 和 VrApi 条目及其相关信息显示在日志文件中。

    T_ADB_Log_Info.png

如 Gear VR 项目无法启动,使用 logcat 命令即可准确查到问题所在及原因。 此外还将获得问题的详细信息,可将其发布到 UE4 论坛或答疑中心,便于获得解决问题的方案。

无线部署和调试

使用 Gear VR 头戴显示器时无法获取调试信息或将项目部署到智能手机,因为唯一的 USB 接口已被显示器占用。 可通过智能手机的 Wifi 连接将调试信息传输到开发电脑,避开这一尴尬的局面。 甚至还可利用此方法部署项目,但速度堪称龟速(较之于 USB 连线传输)。 以下部分将讲述智能手机的设置方法,使其能通过 wifi 发送调试信息并进行部署。

请注意:开发电脑和 Galaxy Note 4 在同一网络时方可成功执行此操作。

  1. 按下 Windows 键 + R 键 打开 Windows 命令窗口,在打开的 Run 对话框中输入 CMD。 然后按下键盘上的 Enter 键或用鼠标点击 OK 键。

    T_Open_CMD_Prompt.png

  2. 按下 OK 键后便会出现类似下图的 Windows 命令行窗口。

    T_Windows_CMD.png

  3. 输入下列命令查看智能手机的 IP 地址,并做好记录。使用的 IP 地址为 inet 后的数字部分。

    adb shell ip -f inet addr show wlan0

    T_ADB_Phone_IP.png

  4. 之后输入下列命令将网络连接改为 TCP,并将端口设为接收。

    adb tcpip 5555

    T_ADB_Set_Port.png

  5. 完成端口设置后即可连接智能手机。输入下列命令并按下 Enter 键即可。

    adb connect 10.3.31.133 - 替换设备的 IP 地址。
  6. 将出现“connected to + 设备 IP 地址”的信息。

    T_ADB_Connected.png

  7. 确保 Wifi 连接正常,在命令行窗口中输入 adb devices 并按下 Enter 键,即可看到 List of devices attached 中唯一一个使用上述 IP 地址的设备。

    T_ADB_Attached_IP.png

通过网络将智能手机和电脑相连之后,即可开始从智能手机获取调试信息,甚至直接通过网络将项目部署到手机。 请注意,通过 USB 连接线部署项目到手机的速度比网络部署快 4-5 倍。

返回有线部署和调试

  1. 在命令窗口中输入下列命令即可返回 USB 连线部署和调试。

    adb usb

    T_ADB_Detached.png