鸿蒙5.0开发进阶:UI框架-ArkTS组件(Component3D)

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:Component3D) ArkTS声明式开发(基础手势:Component3D) 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


Component3D

3D渲染组件,可以加载3D模型资源并做自定义渲染,通常用于3D动效场景。

说明

该组件从API Version 12开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

子组件

无

接口

Component3D(sceneOptions?: SceneOptions)

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

参数:

参数名类型必填说明
sceneOptionsSceneOptions否

3D场景配置选项。

说明:

3D场景配置选项在控件创建后不支持动态修改。

SceneOptions对象说明

Component3D组件配置选项。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

名称类型必填说明
sceneResourceStr|Scene12+否

3D模型资源文件或场景对象,默认值为undefined。

说明:

目前仅支持GLTF格式资源。

modelTypeModelType否

3D场景显示合成方式。

默认值:ModelType.SURFACE

说明:

设置为ModelType.TEXTURE时通过GPU合成显示。

设置为ModelType.SURFACE时通过专有硬件合成显示。

一般开发者可以使用默认值而无需关心此项设置。

ModelType枚举说明

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

名称值说明
TEXTURE0使用GPU合成显示3D场景。
SURFACE1使用专有硬件显示3D场景。

属性

除支持通用属性外,还支持以下属性:

environment

environment(uri: ResourceStr)

设置3D环境资源。目前仅支持GLTF格式资源,模型资源在控件创建后不支持动态修改。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

参数:

参数名类型必填说明
uriResourceStr是3D环境资源。

customRender

customRender(uri: ResourceStr, selfRenderUpdate: boolean)

设置三维场景渲染的渲染管道。管线配置及自渲染属性在控件创建后不支持动态修改。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

参数:

参数名类型必填说明
uriResourceStr是自定义渲染管线的配置文件。
selfRenderUpdateboolean是

当设置为true时外部UI没有更新时也能触发动效渲染。

当设置为false时只有外部UI更新才能触发渲染。

shader

shader(uri: ResourceStr)

设置自定义渲染的shader文件资源。自定义渲染的shader文件资源在控件创建后不支持动态修改。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

参数:

参数名类型必填说明
uriResourceStr是自定义渲染的shader文件资源。

shaderImageTexture

shaderImageTexture(uri: ResourceStr)

设置自定义渲染用到的纹理资源。若自定义渲染用到多个纹理资源则调用多次,绑定点与调用顺序一致,不支持纹理更换。纹理资源在控件创建后不支持动态修改。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

参数:

参数名类型必填说明
uriResourceStr是自定义渲染用到的纹理资源。

shaderInputBuffer

shaderInputBuffer(buffer: Array<number>)

设置自定义渲染用到的动效参数。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

参数:

参数名类型必填说明
bufferArray<number>是自定义渲染用到的动效参数。

renderWidth

renderWidth(value: Dimension)

设置3D渲染分辨率的宽度。渲染分辨率的长宽可以不同于控件的长宽,若渲染分辨率与控件分辨率长宽不一致时会上采样或下采样到控件长宽。

不调用此属性时默认渲染分辨率。

渲染分辨率在控件创建后不支持动态修改。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

参数:

参数名类型必填说明
valueDimension是3D渲染分辨率的宽度。

renderHeight

renderHeight(value: Dimension)

设置3D渲染分辨率的长度。渲染分辨率的长宽可以不同于控件的长宽,若渲染分辨率与控件分辨率长宽不一致时会上采样或下采样到控件长宽。

不调用此属性时默认渲染分辨率。

渲染分辨率在控件创建后不支持动态修改。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUi.Graphics3D

参数:

参数名类型必填说明
valueDimension是3D渲染分辨率的长度。

事件

支持通用事件。

示例

示例效果请以真机运行为准,当前DevEco Studio预览器不支持。

GLTF模型加载示例。

// xxx.ets
@Entry
@Component
struct Index {
  scene: SceneOptions = { scene: $rawfile('gltf/DamageHemlt/glTF/DamagedHelmet.gltf'), modelType: ModelType.SURFACE};
  build() {
    Row() {
      Column() {
        Text('GLTF Example')
        Component3D( this.scene )
          .environment($rawfile('gltf/Environment/glTF/Environment.gltf'))
          .renderWidth('90%').renderHeight('90%')
      }.width('100%')
    }
    .height('100%')
  }
}

自定义渲染示例。

import { Animator as animator, AnimatorResult } from '@kit.ArkUI';

class EngineTime {
  totalTimeUs = 0;
  deltaTimeUs = 0;
};

let engineTime = new EngineTime();
let frameCount: number = 0;

function TickFrame() {
  if (frameCount == 10) {
    engineTime.totalTimeUs += 1.0;
    engineTime.deltaTimeUs += 1.0;
    frameCount = 0;
  } else {
    frameCount++;
  }
}

@Entry
@Component
struct Index {
  scene: SceneOptions = { scene: $rawfile('gltf/DamageHemlt/glTF/DamagedHelmet.gltf'), modelType: ModelType.SURFACE};
  backAnimator: AnimatorResult = animator.create({
    duration: 2000,
    easing: "ease",
    delay: 0,
    fill: "none",
    direction: "normal",
    iterations: -1,
    begin: 100,
    end: 200,
  });
  @State timeDelta: number[] = [1.0, 2.0];
  create() {
    this.backAnimator.onfinish = () => {
      console.log('backAnimator onfinish');
    }
    this.backAnimator.onframe = value => {
      TickFrame();
      this.timeDelta[0] = engineTime.deltaTimeUs;
    }

  }
  build() {
    Row() {
      Column() {
        Text('custom rendering')
        Component3D()
          .shader($rawfile('assets/app/shaders/shader/London.shader'))
          .shaderImageTexture($rawfile('assets/London.jpg'))
          .shaderInputBuffer(this.timeDelta)
          .customRender($rawfile('assets/app/rendernodegraphs/London.rng'), true)
          .renderWidth('90%').renderHeight('90%')
          .onAppear(() => {
            this.create();
            this.backAnimator.play();
          }).width('50%').height('50%')
      }.width('100%')
    }
    .height('100%')
  }
}

鸿蒙HarmonyOS NEXT开发:Component3D(基础组件) 3D渲染组件,可以加载3D模型资源并做自定义渲染,通常用于3D动效场景。 阅读详情

相关推荐

鸿蒙5.0实战开发:3D图形>ArkGraphics 3D场景搭建以及管理

开发者也可以使用ArkTS API对相机和光源进行调节,获得合适的观察角度和光照效果。ArkTS API可通过napi调用AGP中由C++实现的相应能力。

yguyf1235的博客 2056

 HFSS 3D Components模型创建与使用--a3dcomp模型使用

(转载文章,原文链接:http://www.idaj.cn/news/show/id/4552) 以往部件厂家与系统应用厂家需要达成保密协议,系统厂家把系统模型给部件厂家、或部件厂家把部件模型给系统厂家,这对双方的知识产权保护带来困扰。然而,随着HFSS 3D Component模型的可用性,对某些产品的这些限制需求现在已经被消除。HFSS 3D Component全新的模型建立、保护与使用方式大幅提升仿真效率。该功能可以将任意仿真模型保存为3D Component,包括完备的属性及设置,可帮助工程师与.

白浪的博客 1万+

鸿蒙5.0版开发:ArkTS组件-Component3D

3D渲染组件,可以加载3D模型资源并做自定义渲染,通常用于3D动效场景。

m0_69424697的博客 1115

鸿蒙开发系列教程(五)--ArkTS语言:组件开发

自定义组件具有以下特点:可组合:允许开发者组合使用系统组件、及其属性和方法。可重用:自定义组件可以被其他组件重用,并作为不同的实例在不同的父组件或容器中使用。数据驱动UI更新:通过状态变量的改变,来驱动UI的刷新。在另外的文件中引用该自定义组件,需要使用export关键字导出,并在使用的页面import该自定义组件Test01.ets 子组件export导出Test02 父组件import导入main_pages.json 路由index.ets 主页运行效果。

huazi99于老师的博客 1872

鸿蒙5.0版开发:ArkTS组件-基础组件(Component3D)

3D渲染组件,可以加载3D模型资源并做自定义渲染,通常用于3D动效场景。

m0_69424697的博客 1396

Unity开发者迁移指南:在HarmonyOS NEXT中实现3D物体控制

3D图形渲染与交互是现代应用开发的核心技术之一,其原理在于通过图形API(如WebGL)将三维模型数据转换为屏幕上的二维像素。在跨平台开发中,状态驱动架构成为连接UI逻辑与渲染引擎的关键,它通过数据绑定实现状态变化到视觉更新的自动同步,从而提升开发效率和可维护性。这种模式在构建沉浸式3D界面(如产品展示、AR应用)时价值显著,能够分离业务逻辑与渲染细节。本文以HarmonyOS NEXT为应用场景,详细解析了如何将Unity中经典的命令式物体控制逻辑,迁移至鸿蒙声明式开发生态。通过结合WebGL组件与Thr

weixin_30673611的博客 400

【鸿蒙next开发】ArkUI框架:ArkTS组件-Component3D

本文介绍了鸿蒙5.0中Component3D组件的基本功能和使用方法。

m0_73088370的博客 1170

Unity开发者快速上手鸿蒙应用开发:核心概念映射与实战指南

声明式UI是现代前端与跨平台开发中的核心范式,它通过描述UI的最终状态而非一步步的命令式操作,实现了数据与视图的自动同步。其原理在于响应式数据绑定,当底层数据变化时,框架会自动计算并更新受影响的视图部分,这极大地提升了开发效率并减少了状态不一致的Bug。在工程实践中,这种模式对于构建复杂、动态的用户界面具有显著价值,广泛应用于移动应用、Web前端及新兴的操作系统UI框架中。本文聚焦于鸿蒙(HarmonyOS)的方舟开发框架(ArkUI),它正是声明式UI的典型代表。对于熟悉Unity组件化开发与数据驱动思维

weixin_34301132的博客 460

Qt for HarmonyOS_PC ComboBox 组件开源鸿蒙PC开发实践

本文介绍了一个基于Qt Quick Controls 2.15的HarmonyOS应用项目,实现了省份-城市二级联动选择功能。

2511_94246476的博客 1424

Xilinx Blockset Counter计数器模块使用及参数配置

本文详细介绍了Simulink中Xilinx Blockset库Counter模块的使用以及参数说明。

白码王子小张的博客 1097

Sharding-JDBC 系列专题 - 第九篇:高可用性与集群管理

高可用性是指系统在面对故障(如数据库宕机、网络中断)时,能够快速恢复并继续提供服务。Sharding-JDBC 和 Sharding-Proxy 提供了多种机制支持高可用性,同时需要结合底层数据库的高可用方案(如 MySQL 主从复制、MHA)来实现。高可用性和集群管理是 Sharding-JDBC 和 Sharding-Proxy 在生产环境中成功应用的关键。本篇详细介绍了数据库高可用方案、Sharding-JDBC 的故障切换机制、Sharding-Proxy 的集群部署,以及分布式治理功能。

资深架构师分享:深入剖析软件架构,探讨云计算、微服务、大数据等前沿技术。分享实践经验,促进技术交流,共同构建卓越系统。 1393

HarmonyOS6 PC 端 XComponent 组件全面解析:嵌入原生渲染内容的利器

在 HarmonyOS ArkUI 的组件体系里,绝大多数组件都是"声明式"的——你用 ArkTS 描述 UI 结构,框架负责渲染到屏幕上。高性能的原生图形渲染,比如游戏引擎渲染、OpenGL 绘图、视频解码输出、AR/VR 场景。这时候就需要XComponent。它是 ArkUI 中的一个"开口",允许你把 EGL/OpenGL ES 渲染内容、Native 层的 UIAbility 组件,甚至纹理共享内容嵌入到 ArkUI 的页面中,和普通组件一起布局。理解XComponent。

qq_37048082的博客 6754

T100服务端接口实战:从注册到日志排查的全链路开发指南

本文提供了一份T100服务端接口开发的全链路实战指南。从程序注册与框架签出开始,详细讲解了接口的数据结构设计、核心业务逻辑编写,到最终的部署上线与调用验证。文章重点分享了如何利用日志文件高效定位和排查接口问题,帮助开发者快速掌握T100接口开发的关键步骤与实用技巧。

weixin_28831399的博客 300

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 3D旋转(透视变换):使用 Transform组件的 Matrix4进行3D变换。

自定义组件:创建了状态ful组件,实现功能封装与代码复用,提高开发效率参数传递:采用命名参数和可选参数设计,为每个参数提供合理的默认值,增强组件灵活性与可配置性组件组合:通过组合内置组件(如ContainerText等)构建复杂 UI 界面。

xiaoqi922的博客 604

嵌入式Linux网络调试:YT8531/YT8521 PHY驱动移植与设备树配置避坑指南

本文深入解析嵌入式Linux系统中YT8531/YT8521 PHY驱动移植与设备树配置的关键技术,涵盖内核驱动适配、RGMII接口时序调整及常见问题排查。针对Motorcomm千兆以太网PHY芯片,提供详细的设备树配置示例和调试技巧,帮助开发者规避典型设计陷阱,确保网络功能稳定运行。

weixin_42525632的博客 677

文石NoteX3国行版安装 Google Play经验分享

文石NoteX3国行版安装 Google Play经验分享。

2301_80693261的博客 7621

Qt for 鸿蒙PC Slider 组件开源鸿蒙PC开发实践

本文介绍了基于Qt在HarmonyOS平台开发的RGB颜色选择器项目。项目通过三个Slider控件控制红绿蓝颜色通道,实现实时颜色预览和RGB数值输入的双向绑定。

qq_34025996的博客 1374

PCL 点云加权均值收缩

PCL 点云加权均值收缩

dayuhaitang1的博客 689

基于HarmonyOS API 24 【精通篇】打造React Native鸿蒙跨平台开发高级复合组件库开发系列:基于字体的图标集的Icon组件

Python 语法首先被转换成抽象语法树(Abstract Syntax Tree,AST),然后才被编译成字节码。这是对源代码抽象语法结构的一种树状表示。利用内置的 ast 模块,可以得到对Python 语法的处理过程。利用带有 ast.PyCF_ONLY_AST 标记的 compile()函数或者利用 ast.parse()帮助函数,可以创建 Python 代码的原始 AST。逆向直接转换却没有那么简单,没有用于完成这项功能的内置函数。不过有些项目(例如 PyPy)可以完成这项任务。

2401_86113894的博客 813

17、超声散斑降噪与桌面系统背景估计技术

本文介绍了超声散斑降噪与桌面系统背景估计的先进技术。在超声成像方面,提出结合超分辨率(SR)和非线性扩散(ND)的方法,显著降低噪声并保留图像细节,在MSE和CNR指标上优于传统方法。在桌面交互系统中,针对传统背景估计因忽略设备像素结构导致的误差,提出基于显示器与相机像素结构建模的几何转换方法,有效减少尖锐边缘区域的误检,提升物体识别准确性。实验验证了两种方法的有效性,未来将致力于实时性优化与多设备兼容性扩展。

dream的博客 88

46、大数据助力SDN优化流量管理与控制器

本文探讨了大数据在软件定义网络(SDN)中的应用,重点分析了如何利用大数据技术优化SDN控制器的可扩展性和弹性。通过介绍SDN控制器的核心功能及其面临的挑战,提出了集中式、分布式、混合式和分层式控制器放置策略,并结合大数据分析系统架构与技术,详细阐述了在控制器放置优化、流聚合和备份路径识别等场景中的实际应用。文章还给出了大数据分析在SDN控制器优化中的操作流程与优势,展望了未来结合人工智能与物联网的发展方向,强调了数据安全与算法效率的重要性。

xx56789的博客 87

【精通篇】基于HarmonyOS API 24 打造React Native鸿蒙跨平台开发高级复合组件库开发系列:基于字体的图标集的Icon组件

因为Web Socket 使用了自定义协议,所以URL 方案(scheme)稍有变化:不能再使用http://或https://,因为Web Socket 使用了自定义协议,所以URL 方案(scheme)稍有变化:不能再使用http://或https://,调用close()之后,readyState 立即变为2(连接正在关闭),并会在关闭后变为3(连接已经关闭)。调用close()之后,readyState 立即变为2(连接正在关闭),并会在关闭后变为3(连接已经关闭)。在JavaScript。

wanmeijuhao的博客 479

ET2012新版免狗免安装绿色软件

ET2012新版免狗免安祖昂绿色软件。,新界面,新视觉,

在React Native鸿蒙组件(Hong Components,基于HarmonyOS API 24 这里指的是一个虚构或特定的组件名称,假定其为一种自定义或第三方组件)并实现保养日志记录功能

假如没有发送Content-Type 头部,PHP 的全局$_POST 变量中就不会包含数据,而需要通过。在这个函数中,来自ID 为"user-info"的表单中的数据被序列化之后发送给了服务器。请求体中携带提交的数据,而GET 请求则不然。POST 请求的请求体可以包含非常多的数据,而且数据。第二个最常用的请求是POST 请求,用于向服务器发送应该保存的数据。步是创建对应格式的字符串。最常用的请求方法是GET 请求,用于向服务器查询某些信息。默认情况下,对服务器而言,POST 请求与提交表单是不一样的。

wanmeijuhao的博客 465

Outlook Express 6 (OE6) for Win7/Win8/Win10

英文版 Outlook Express6.0, 兼容Win7/Win10/WinXP,解压就可用。

锂电池充电器电路设计 里面有电路

锂电池充电器电路设计 里面有电路 3.7V升压到5V电路设计。

Qt for HarmonyOS PushButton 组件开源鸿蒙PC开发实践

本文档介绍了基于Qt开发的HarmonyOS按钮组件项目,实现了11种不同样式的30多个按钮示例。项目详细展示了Qt Quick Controls 2.15在HarmonyOS平台的应用,包括基础样式、状态变化、渐变背景、边框效果、图标按钮等多种实现方案。

2511_94246476的博客 650

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

React使用useState来维护组件的内部状态,React Native鸿蒙使用@State装饰器实现类似的状态管理机制,基于HarmonyOS API 24 状态变量变化来驱动UI的自动更新

http://www.wrox.com/books/访问,因此访问http://www.wrox.com/下的页面就不会发送cookie,即。这个头部设置一个名为"name"的cookie,这个cookie 在2007 年1 月22 日7:10:24 过期,对。www.wrox.com),也可以不包含(如.wrox.com 表示对wrox.com 的所有子域都有效)。求https://www.wrox.com 会发送cookie,而请求http://www.wrox.com则不会。这个值可能包含子域(如。

wanmeijuhao的博客 297

React Native跨平台技术开发无冗余状态仅维护一个状态变量即可实现所有分类项的选中状态管理,基于HarmonyOS API 24 减少状态管理的复杂度

克隆Response 对象的主要方式是使用clone()方法,这个方法会创建一个一模一样的副本,不。如果响应对象的bodyUsed 属性为true(即响应体已被读取),则不能再创建这个对象的副本。此外,通过创建带有原始响应体的Response 实例,可以执行伪克隆操作。对于重定向响应,这是最终的URL,非重定向响应就是它产生的。Response 对象包含一组只读属性,描述了请求完成后的状态,如下表所示。 error:表示响应对象是通过Response.error()创建的。可能是下列字符串值之一。

wanmeijuhao的博客 453
上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(XComponent)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(EmbeddedComponent)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值