Version: 1.7
语言 : 中文
HMI Android Related Package
QNX

URAS Demo Package

URAS Demo Packege 为团结引擎车机版本 HMI Android 平台独有的 URAS 架构的 Demo。帮助用户迅速上手 URAS 架构开发流程,并展示通过 URAS 架构实现的样例工程,如一镜到底(Package 1.1.0 及以上版本)等。

基础设置

  • 新建项目时需使用 3D(URP) 模版,或切换至 URP 管线使用
  • Build Target 需切换至 HMI Android

下载安装

URAS Demo Package 需通过 Package Manager 下载安装并导入,具体步骤如下:

  1. 打开项目后,点击顶部菜单栏:Windows >> Package Manager,打开 Package Manger 窗口;

    uras-demo-install
    uras-demo-install
  2. 在 Package Manager 窗口中,点击左侧列表切换至 Tuanjie Registry,搜索“uras”,找到 URAS Demo,点击“Install”;

    uras-demo-package-install
    uras-demo-package-install
  3. 成功安装后,点击 Samples >> Import,导入场景。

    uras-demo-import
    uras-demo-import

Guide Window

URAS Demo Package 自带 Guide Window(通过顶部菜单栏打开),所有操作均可通过 Guide Window 实现;

uras-demo-start

点击 Guide Window 左侧目录,可切换不同的 Demo 教程:

  • Getting Started:URAS(非工程隔离模式) 的入门教程,包括 Client 和 Service 的快速构建和分步构建教程。
  • One-shot Transition Sample:一镜到底样例工程教程,使用 URAS 构建两个 Client 和一个 Service 实现跨 Client 间一镜到底转场。
  • Project Separation Build:URAS (工程隔离模式)的入门教程,包括 Client 和 Service 的快速构建和分步构建教程。

Getting Started

URAS(非工程隔离模式) 的入门教程,包括 Client 和 Service 的快速构建和分步构建教程。

  1. 需首先点击“Open the Demo Scene”,打开默认场景,才可继续使用该页面后续功能。默认场景中:

    • 内置一个车模,车模上默认挂载了 Rotating 和 Color Change 两个 Script 脚本,控制车模旋转和改变颜色;
    • 4个 Camera,4个 Camera 分别绑定4个不同的 Display;
    • 4个 Canvas,用于绘制修改 Render Scale 的 UI。
  2. 快速构建:

    uras-demo-quick-build
    uras-demo-quick-build
    • URAS Quick Build 栏提供了一键构建 Client 和 Service 工程的快捷按钮;

    • 点击“Export Service Project”按钮, 自动导出 Service 端的安卓工程;

    • 点击“Export Client Project”按钮,自动导出 Client 端安卓工程;

    • 导出完成后,可按照提示在对应文件夹查看;

    • 使用 Android Studio 分别打开导出的 uras-client 工程和 uras-service 工程; uras-demo-project

    • 工程内,内置配置好 TuanjieView 的 xml 文件,可直接 build APK /连接真机进行调试,也可按需自行配置修改;

      • uras-service 工程:Build >> Build Bundle(s)/APK(s),安装到目标设备并运行(真机上需为service app设置自启动权限);
      • uras-client 工程:Build >> Build Bundle(s)/APK(s),安装到目标设备并运行。
      uras-demo-non-run
      uras-demo-non-run
  3. 分步构建:

    • Service Project - Build Step by Step 栏提供了快速绑定场景中 Camera 和 Display 的功能和分步导出 Service 工程的教程:

      • Target Display Settings 可通过列表快速绑定场景中的 Camera 和 Display;
      • 点击“Build Settings Config“,直达 Build Settings 页修改 HMI Android 平台相关配置,注意取消勾选“Project Separation Mode”;
    • Client Project - Build Step by Step 栏提供了在 Client 工程中设置 renderServiceLibrary 的教程。

One-shot Transition Sample

一镜到底样例工程教程,使用 URAS 构建两个 Client 和一个 Service 实现跨 Client 间一镜到底转场。

uras-demo-one-shot-settings

  1. 需首先点击“Open the Demo Scene”,打开默认场景:

    • Client A Demo Scene 为 Launcher 的示例场景,场景中的 LauncherMainCamera 挂载了 Camera Controller 脚本,以控制一镜到底转场时 Camera 的移动;
    • Client B Demo Scene 为 ADAS 的示例场景,场景中的 ADASMainCamera 挂载了 Camera Controller 脚本,以控制一镜到底转场时 Camera 的移动;
  2. 导出及构建:

    • 点击“Export Service Project”按钮, 自动导出 Service 端的安卓工程;

    • 点击“Export Client A Project”按钮,自动导出 Client 端 Launcher 应用的安卓工程;

    • 点击“Export Client B Project”按钮,自动导出 Client 端 ADAS 应用的安卓工程;

    • 导出完成后,可按照提示在对应文件夹查看;

    • 使用 Android Studio 分别打开导出的 uras-oneshot-adas-client 工程、uras-oneshot-launcher-client 和 uras-oneshot-service 工程; uras-demo-oneshot-project

    • 工程内,内置配置好 TuanjieView 的 xml 文件,可直接 build APK /连接真机进行调试,也可按需自行配置修改;

      • uras-oneshot-service 工程:Build >> Build Bundle(s)/APK(s),安装到目标设备并运行(真机上需为 service app 设置自启动权限);

      • uras-oneshot-launcher-client 工程:Build >> Build Bundle(s)/APK(s),安装到目标设备并运行;点击“START ADAS”,一镜到底切换至 ADAS 应用;

        uras-demo-oneshot-launcher
        uras-demo-oneshot-launcher
      • uras-oneshot-adas-client 工程:Build >> Build Bundle(s)/APK(s),安装到目标设备并运行;点击“START LAUNCHER”,一镜到底切换至 Launcher 应用;

        uras-demo-oneshot-adas
        uras-demo-oneshot-adas

Project Separation Build

URAS (工程隔离模式)的入门教程,包括 Client 和 Service 的快速构建和分步构建教程。

  1. 需首先点击“Open the Demo Scene”,打开默认场景,才可继续使用该页面后续功能。默认场景中:

    • 内置一个车模,车模上默认挂载了 Rotating 和 Color Change 两个 Script 脚本,控制车模旋转和改变颜色;
    • 4个 Camera,4个 Camera 分别绑定4个不同的 Display;
    • 4个 Canvas,用于绘制修改 Render Scale 的 UI。
  2. 快速构建:

    uras-demo-separation-quick-build

    • Project Separation Mode Quick Scene 栏提供了一键构建 Client 和 Service 工程的快捷按钮;

    • 点击“Export Service Project”按钮, 自动导出 Service 端的安卓工程;

    • 点击“Change Assembly”按钮,自动为项目设置 Assembly Name;

    • 设置好 Assembly Name 后,才可一键导出 Client 工程,点击“Export Client Project”按钮,自动导出 Client 端安卓工程;

    • 导出完成后,可按照提示在对应文件夹查看;

    • 使用 Android Studio 分别打开 PS-uras-client 工程和 PS-uras-service 工程;

    • 工程内,内置配置好 TuanjieView 的 xml 文件,可直接 build APK /连接真机进行调试,也可按需自行配置修改;

      • PS-uras-service 工程:Build >> Build Bundle(s)/APK(s),安装到目标设备并运行(真机上需为service app设置自启动权限);
      • PS-uras-client 工程:Build >> Build Bundle(s)/APK(s),安装到目标设备并运行。
  3. 分步构建:

    • Service Project - Build Step by Step 栏提供了分步导出 Service 工程的教程:

      • 点击“Build Settings Config“,直达 Build Settings 页修改 HMI Android 平台相关配置,注意勾选“Project Separation Mode”;
    • Client Project - Build Step by Step 栏提供了快速绑定场景中 Camera 和 Display 的功能、分步导出 Client 工程、在 Client 工程中设置 renderServiceLibrary 的教程:

      • Target Display Settings 可通过列表快速绑定场景中的 Camera 和 Display;
      • 点击“Build Settings Config“,直达 Build Settings 页修改 HMI Android 平台相关配置,注意取消勾选“Project Separation Mode”。

相关资料

URAS详细架构及操作说明见:HMI Android

HMI Android Related Package
QNX