URAS Demo Package

URAS Demo Packege 为团结引擎车机版本 HMI Android 平台独有的 URAS 架构的 Demo。帮助用户迅速上手 URAS 架构开发流程，并展示通过 URAS 架构实现的示例工程，如一镜到底（Package 1.1.0 及以上版本），灵动视窗，AppView投屏等。需安装Tuanjie引擎1.8.3及以上版本或HMI推荐引擎1.6.10及以上版本。

基础设置

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

下载安装

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

1. 打开项目后，点击顶部菜单栏：Windows >> Package Manager，打开 Package Manger 窗口；

   

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

   

3. 成功安装后，点击 Samples >> Import，导入场景。

   

Guide Window

URAS Demo Package 自带 Guide Window（通过顶部菜单栏打开），所有操作均可通过 Guide Window 实现；

点击 Guide Window 左侧目录，可切换不同的示例工程：

• Getting Started：URAS（非工程隔离模式）的示例工程，是URAS亮点功能示例合集，并在此快速构建所有Client 和 Service 工程。
• Project Separation Build：URAS （工程隔离模式）的示例工程，包含 Client 和 Service 的快速构建和分步构建教程。
• One-shot Transition Sample：一镜到底示例工程，使用 URAS 构建两个 Client 和一个 Service 实现跨 Client 间一镜到底转场。
• Flexible Window Sample​：灵动视窗示例工程, 实现视窗丝滑变化效果。
• App View Sample​：安卓投屏示例工程，展示安卓工程界面以2d或3d的形式呈现在场景中。

Getting Started

URAS（非工程隔离模式）的示例工程，是URAS亮点功能示例合集，并在此快速构建所有Client 和 Service 工程。

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

2. 默认场景中：

   • 内置一个车模，车模上默认有Color Change 的Script 脚本，控制车模改变颜色；
   • 内置一个场地模型，模拟实际城市场景；
   • 3个 Camera，分别绑定3个不同的 Display；

3. 快速构建：

   

   • URAS Quick Build 栏提供了一键构建 Client 和 Service 工程的快捷按钮；
   • 点击“Export Service Project”按钮， 自动导出 Service 端的安卓工程；
   • 点击“Export Client Launcher Project”按钮，自动导出亮点功能合集Client 端安卓工程；
   • 点击“Export Client ADAS Project”按钮，自动导出一镜到底功能需要的Client 端安卓工程；
   • 导出完成后，可按照提示在对应文件夹查看；
   • 使用 Android Studio 分别打开导出的uras-service工程，uras-client 工程 和uras-oneshot-adas-client工程；

   

   • 工程内，内置配置好 TuanjieView 的 xml 文件，可直接 build APK /连接真机进行调试，也可按需自行配置修改，推荐如图所示Gradle；

   

   - uras-service 工程：Build >> Build Bundle(s)/APK(s)，安装到目标设备并运行（真机上需为service app设置自启动权限）；
   - uras-client 工程：Build >> Build Bundle(s)/APK(s)，安装到目标设备并运行。
   - uras-oneshot-adas-client工程：Build >> Build Bundle(s)/APK(s)，安装到目标设备并运行。
   

   

4. 分步构建：
   • 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 的教程。

Getting started scene功能介绍

1. uras-client应用首页为Getting started scene，可点击右上角下拉菜单切换不同Sample Scene；
2. 启用/停止渲染画面；
3. 添加新窗口，可下拉更改target display切换对应窗口的渲染画面；
4. 仅Target display1的车模窗口支持触摸旋转查看车模，和设置背景透明功能；
5. 可横向滑动屏幕查看更多窗口；

Project Separation Build

URAS （工程隔离模式）的入门教程，包括 Client 和 Service 的快速构建和分步构建教程。

1. 需首先点击“Open the Demo Scene”，打开默认场景，才可继续使用该页面后续功能。默认场景中：
   • 内置一个车模，车模上默认有Color Change 的Script 脚本，控制车模改变颜色；
   • 内置一个场地模型，模拟实际城市场景；
   • 3个 Camera，分别绑定3个不同的 Display；

2. 快速构建：

   

   • 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”。

One-shot Transition Sample

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

1. 需首先点击“Open Demo Scene”，打开默认场景：

   • One-shot Transition Scene 为 一镜到底的初始示例场景Launcher，场景中的 LauncherMainCamera 挂载了 Camera Controller 脚本，以控制一镜到底转场时 Camera 的移动；
   • One-shot Transition ADAS Scene 为 一镜到底的结尾示例场景ADAS，场景中的 ADASMainCamera 挂载了 Camera Controller 脚本，以控制一镜到底转场时 Camera 的移动；
2. 导出及构建工程均在”Getting started“中完成，仅需将当前场景切换至One-shot Transition Scene；
   • 注意：一镜到底需要两个client工程，请确保uras-service工程，uras-client 工程 和uras-oneshot-adas-client工程均安装并运行；

3. 点击“Switch to ADAS client”，一镜到底切换至 ADAS 应用；

1. 点击“Back to Launcher client”，一镜到底切换至 Launcher 应用；

Flexible Window Build

URAS 灵动视窗模式的示例工程，使用该示例工程可实现灵动视窗功能的简单演示。

1. 该示例工程与ADAS Scene共用一个场景, 默认场景中置入车模和场地模型；

   • 1个 Camera，用于显示3D场景在灵动视窗下的变换；
   • 1个 Canvas，用于显示2D内容在灵动视窗下的变换；

2. 导出及构建工程均在”Getting started“中完成，仅需右上角下拉菜单，将当前场景切换至Flexible Window Scene；

3. 点击”Random Resolution“可持续随机变化视窗大小，点击”Stop Changing“停止变化；

4. 支持自定义输入窗口大小和自定义灵动视窗动效时间；

5. 支持拖拽窗口边角自由调整大小以展示灵动视窗效果；

App View Sample

安卓应用投屏示例工程，展示第三方安卓应用以2D或3D的形式投屏在Tuanjie3D场景中。

1. 需首先点击“Open Demo Scene”，打开默认场景：
   • 内置车模，场地模型和展示板模型；
   • 一个2D panel，一个3D panel，分别接收安卓view投屏；

2. 导出及构建工程均在”Getting started“中完成，仅需将当前场景切换至App View Scene；

3. Client端界面展示：

相关资料

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