概述

ViroCore是一个基于React Native的跨平台AR/VR引擎，可以用于创建高质量的AR和VR应用程序。以下是ViroCore的主要用途： 1. 游戏和娱乐：ViroCore可以用于创建有趣的游戏和娱乐应用程序，支持丰富的图形和动画效果，以及手势识别、定位跟踪等高级功能。 2. 商业应用：ViroCore可以用于商业应用领域，如虚拟展厅、产品演示等。它可以为企业提供沉浸式的虚拟体验，让客户更好地了解产品和服务。 3. 教育和培训：ViroCore可以用于教育和培训领域，为学生和员工提供交互式的虚拟体验。它可以模拟历史事件、自然现象、技能操作等场景，提供更加直观和实践的学习方式。 4. 工程设计：ViroCore可以用于工程设计和建模领域，如建筑、机械、电子等。它可以为设计师提供可视化的工具和模拟环境，以便进行设计和测试。 总之，ViroCore是一个功能强大的AR/VR开发引擎，可用于游戏和娱乐、商业应用、教育和培训、工程设计等多个领域。ViroCore的主要特点是跨平台性、易学易用和高度可定制化，使其成为开发AR/VR应用程序的理想选择。

支持平台：Android、ARCore、Google Daydream、Samsung GearVR、Google Cardboard VR

该存储库包含渲染源代码以及 ViroCore 平台。两者都可以免费使用，没有分发限制。

发布

ViroCore 下载可在我们的发布页面上获得。

快速开始

运行示例代码说明：

您可以使用最新稳定版本的 ViroCore 启动并运行！为此，只需：

1. [hidecontent type="logged" desc="隐藏内容：登录后可查看"]

   1. 按照我们的快速入门指南中的先决条件说明设置依赖项，以便使用 Viro Media App 尝试这些示例项目。
   2. 使用 git: 将 repo 克隆到你的工作区git clone https://github.com/viromedia/virocore.git。
   3. 转到代码示例目录以获取当前示例列表。
   4. 选择您要部署的代码示例，然后在 Android studio 中打开根目录。
   5. 确保禁用Instant Run 。
   6. （可选）清理和 gradle 同步。
   7. 构建和部署。
   8. 您现在应该在应用程序中！享受！

   从主线使用预构建的 ViroCore：

   您还可以尝试包含前沿功能和修复的最新主线版本。请记住，主线构建可能不如发布构建稳定。为此，只需：

   1. 转到此项目的ViroCore 操作工作流。
   2. 您应该会看到“Viro Renderer CI Pipeline”工作流程列表。
   3. 单击最新成功构建的工作流管道（应该有一个复选标记）。
   4. 您现在应该看到与该流关联的上传工件。例如：
      • viroreact.aar（用于 ViroReactAndroid）
      • virocore.aar（用于 ViroCore）
      • ios_dist.tgz（适用于 iOS）

   对于 ViroCore Android，HelloWorld 示例应在 viro_core/virocore-release -version位置具有相应的文件。因此，只需从上面的工作流中下载 virocore.aar 工件，然后重命名（确保它与您的代码示例的名称匹配）并替换 HelloWorld 项目中的 virocore-release-v_x_xx_x.aar 文件

   渲染器的手动构建

   如果您想直接修改/更改渲染器。这些是构建渲染器和 ViroCore 平台的说明。

   构建 ViroCore 平台：

   1. 按照我们的快速入门指南中的上述相同先决条件说明进行操作。
   2. 使用 git: 将 repo 克隆到你的工作区git clone https://github.com/viromedia/virocore.git。
   3. 执行以下命令构建 ViroCore 平台库

      $ cd android
      $ ./gradlew :virocore:assembleRelease
      

   4. 如果上述 gradle 构建成功，请确认您virocore-*.aar在以下位置看到了一个文件（* 表示版本号）android/virocore/build/outputs/aar/virocore-*.aar
   5. android/app要运行 ViroCore 测试，请在 Android Studio 中打开 android 项目并releasetest在您的 android 设备上运行 target。
   6. 要在您自己的项目中使用此更新/新建，virocore-*.aar请将 aar 文件复制到viro_core/您的项目中并修改您的viro_core/build.gradle文件以指向新文件。

   (Android) 构建用于 react-viro 平台的渲染器：

   1. 按照我们的快速入门指南中的上述相同先决条件说明进行操作。
   2. 使用 git: 将 repo 克隆到你的工作区git clone https://github.com/viromedia/virocore.git。
   3. 使用 git 在同一工作区（与 virocore 相同的父目录）中克隆 react-viro repo（名为 viro）：https://github.com/viromedia/viro.git
   4. 执行以下命令构建 ViroCore 平台库

      $ cd android
      $ ./gradlew :viroreact:assembleRelease
      

   5. 如果上述 gradle 构建成功，请确认您viroreact-release.aar在/viroreact/build/outputs/aar/viroreact-release.aar.
   6. viro/android/viro_renderer/viro_renderer-release.aar此外，请确认您在上面的步骤 #3 中克隆的 viro 存储库中看到了一个新文件。viro repo中概述的构建说明将引导您完成使用此构建的渲染器构建 react-viro 桥所涉及的步骤。

   (iOS) 构建用于 react-viro 平台的渲染器：

   1. 确保您已完成 android 部分中提到的步骤 1 - 3。

   2. 执行以下命令从Podfile.

      cd ios
      pod install
      

   3. 在 Xcode 中打开ViroRenderer.xcworkspace。构建方案ViroKit，构建配置设置为Release，目标设置为Generic iOS Device。 笔记：

      3.a If you want the ability to run on Simulator, 
          change target to any of the `iOS Simulator` targets instead of `Generic iOS Device`. 
      3.b If in your own app project setup, you prefer to include react-viro as a static library 
          rather than relying on `use_frameworks!` - build scheme `ViroKit_static_lib` 
          instead of `ViroKit` as mentioned above in step #3. 
      

   4. 如果上面的 Xcode 构建成功，您应该会看到一堆新文件被复制到viro/ios/dist/您之前克隆的 viro 存储库的文件夹中。viro repo中概述的构建说明将引导您完成使用此构建的渲染器构建 react-viro 桥所涉及的步骤。

   [/hidecontent]