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 窗口；

   

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

   

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

   

Guide Window

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

点击 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 Quick Build 栏提供了一键构建 Client 和 Service 工程的快捷按钮；

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

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

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

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

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

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

     

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 间一镜到底转场。

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 工程；

   • 工程内，内置配置好 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-oneshot-adas-client 工程：Build >> Build Bundle(s)/APK(s)，安装到目标设备并运行；点击“START LAUNCHER”，一镜到底切换至 Launcher 应用；

       

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. 快速构建：

   

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

Flexible Window Build

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

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

   • 内置一个车模，车模上默认挂载了 Rotating 和 Color Change 两个 Script 脚本，控制车模旋转和改变颜色；
   • 1个 Camera，用于显示3D场景在灵动视窗下的变换；
   • 1个 Canvas，用于显示2D内容在灵动视窗下的变换。

2. 快速构建：

   

   • Flexible Window Demo Quick Build 栏提供了一键构建 Client 和 Service 工程的快捷按钮；

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

   • 点击“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. Client端功能展示：

   

   • 修改分辨率和灵动视窗动画时长 ：

   • 点击Resolution可以自由设置灵动视窗变换的宽高，也可以通过点击 Auto Set Resolution自动设置预设的四种分辨率；
     • 点击Delay MiliSec可以设置灵动视窗动画时长，单位为毫秒(ms)。

   • 灵动视窗效果展示 ：

   • 点击Change Resolution With Flexible Window即可显示灵动视窗效果（注：如果前后分辨率一致则无变化）
     • 勾选Switch To Drag，可通过触控按住tuanjieView右下角进行自由拖动显示灵动视窗效果。

相关资料

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