智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
native_material.h
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
本文导读
概述
提供ArkUI（方舟UI框架）在Native侧的沉浸式材质类型和API声明，用于实现半透明模糊背景、光感交互反馈等沉浸式UI效果。
引用文件： <arkui/native_material.h>
库： libace_ndk.z.so
系统能力： SystemCapability.ArkUI.ArkUI.Full
相关模块： ArkUI_NativeModule
起始版本： 26.0.0
汇总
枚举
| 名称 | typedef关键字 | 描述 |
|---|---|---|
| ArkUI_ImmersiveStyle | ArkUI_ImmersiveStyle | 沉浸式材质样式，取值范围见ArkUI_ImmersiveStyle。传入无效样式将导致创建失败返回NULL。不同样式对应不同的材质参数，影响材质的薄厚程度和透明度。 |
| ArkUI_MaterialLevel | ArkUI_MaterialLevel | 材质等级枚举，与设备的算力等级相关。使用OH_ArkUI_NativeModule_GetGlobalMaterialLevel可获取当前设备的材质等级。 |
结构体
| 名称 | typedef关键字 | 描述 |
|---|---|---|
| ArkUI_ImmersiveMaterial | ArkUI_ImmersiveMaterial | 定义Native侧的沉浸式材质对象。沉浸式材质根据设备算力等级分为不同等级。材质等级由ArkUI_MaterialLevel定义，可通过OH_ArkUI_NativeModule_GetGlobalMaterialLevel获取。在高算力和中算力设备上，会影响材质层的滤镜效果和阴影（NODE_SHADOW或NODE_CUSTOM_SHADOW）效果。在低算力设备上，会影响背景颜色NODE_BACKGROUND_COLOR、边框颜色NODE_BORDER_COLOR、边框宽度NODE_BORDER_WIDTH和阴影（NODE_SHADOW或NODE_CUSTOM_SHADOW）效果。 |
| ArkUI_ImmersiveMaterial* | ArkUI_ImmersiveMaterialHandle | 定义指向沉浸式材质对象的指针，沉浸式材质用于实现沉浸式视觉效果。可以通过OH_ArkUI_NativeModule_ImmersiveMaterial_Create创建沉浸式材质对象。可以通过OH_ArkUI_NativeModule_ImmersiveMaterial_Destroy接口销毁沉浸式材质对象。待销毁的沉浸式材质对象应是通过OH_ArkUI_NativeModule_ImmersiveMaterial_Create创建的有效对象。 |
| ArkUI_LightEffectOptions | ArkUI_LightEffectOptions | 定义沉浸式材质的光感交互效果配置对象，用于配置沉浸式材质在用户交互时产生的光感响应效果。创建后需通过OH_ArkUI_NativeModule_ImmersiveMaterial_SetLightEffect将配置对象设置到沉浸式材质对象上才能生效。创建时默认光感交互颜色为白色（0xffffffff）。 |
| ArkUI_LightEffectOptions* | ArkUI_LightEffectOptionsHandle | 定义指向光感交互效果配置对象的指针，开发者通过该指针可配置和管理沉浸式材质的光感交互效果参数。可以通过OH_ArkUI_NativeModule_LightEffectOptions_Create创建光感交互效果配置对象。可以通过OH_ArkUI_NativeModule_LightEffectOptions_Destroy接口销毁光感交互效果配置对象。待销毁的光感交互效果配置对象应是通过OH_ArkUI_NativeModule_LightEffectOptions_Create创建的有效对象。 |
函数
枚举类型说明
ArkUI_ImmersiveStyle
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
enum ArkUI_ImmersiveStyle
沉浸式材质样式枚举。不同样式对应不同的材质参数，影响材质的薄厚程度。
起始版本： 26.0.0
| 枚举项 | 描述 |
|---|---|
| ARKUI_IMMERSIVE_STYLE_ULTRA_THIN = 0 | 超薄样式。材质层极薄，透明度效果极强。 |
| ARKUI_IMMERSIVE_STYLE_THIN = 1 | 薄样式。材质层较薄，透明度效果强。 |
| ARKUI_IMMERSIVE_STYLE_REGULAR = 2 | 常规样式。材质层厚度标准，视觉效果均衡。 |
| ARKUI_IMMERSIVE_STYLE_THICK = 3 | 厚样式。模糊效果强。 |
| ARKUI_IMMERSIVE_STYLE_ULTRA_THICK = 4 | 超厚样式。材质层极厚，模糊效果极强。 |
ArkUI_MaterialLevel
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
enum ArkUI_MaterialLevel
材质等级枚举，与设备的算力等级相关。
使用OH_ArkUI_NativeModule_GetGlobalMaterialLevel可获取当前设备的材质等级。
起始版本： 26.0.0
| 枚举项 | 描述 |
|---|---|
| ARKUI_MATERIAL_LEVEL_EXQUISITE = 0 | 高算力设备材质等级。 |
| ARKUI_MATERIAL_LEVEL_GENTLE = 1 | 中算力设备材质等级。 |
| ARKUI_MATERIAL_LEVEL_SMOOTH = 2 | 低算力设备材质等级。 |
函数说明
OH_ArkUI_NativeModule_GetSystemMaterialSupported()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
bool OH_ArkUI_NativeModule_GetSystemMaterialSupported()
描述：
检查当前设备是否支持系统材质（即设备系统内置的材质渲染能力）。
如果返回true，则可以使用NODE_SYSTEM_MATERIAL属性，否则设置该属性将无效。该配置项由设备定义，不可修改。
起始版本： 26.0.0
返回：
| 类型 | 说明 |
|---|---|
| bool | 返回当前设备是否支持系统材质。true表示当前设备支持系统材质，false表示当前设备不支持系统材质。 |
OH_ArkUI_NativeModule_GetGlobalMaterialLevel()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_MaterialLevel OH_ArkUI_NativeModule_GetGlobalMaterialLevel()
描述：
获取全局材质等级，与设备的算力相关。该配置项由设备定义，不可修改。
起始版本： 26.0.0
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_MaterialLevel | 返回设备的材质等级。 ARKUI_MATERIAL_LEVEL_EXQUISITE（0）：高算力设备材质等级。 ARKUI_MATERIAL_LEVEL_GENTLE（1）：中算力设备材质等级。 ARKUI_MATERIAL_LEVEL_SMOOTH（2）：低算力设备材质等级。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_Create()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ImmersiveMaterialHandle OH_ArkUI_NativeModule_ImmersiveMaterial_Create(ArkUI_ImmersiveStyle style)
描述：
创建具有指定样式的沉浸式材质对象。创建的材质等级跟随全局材质等级，可通过OH_ArkUI_NativeModule_GetGlobalMaterialLevel获取。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveStyle style | 材质样式。传入无效样式将导致设置失败，返回ARKUI_ERROR_CODE_PARAM_INVALID错误码。该样式仅对高算力和中算力设备的显示效果有效，对低算力设备不生效但不会报错。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ImmersiveMaterialHandle | 返回指向创建的沉浸式材质对象的指针。如果创建失败或材质样式无效，返回NULL。 返回的对象使用完后需要通过OH_ArkUI_NativeModule_ImmersiveMaterial_Destroy释放。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_Destroy()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
void OH_ArkUI_NativeModule_ImmersiveMaterial_Destroy(ArkUI_ImmersiveMaterialHandle material)
描述：
销毁沉浸式材质对象。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_SetStyle()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_SetStyle(ArkUI_ImmersiveMaterialHandle material, ArkUI_ImmersiveStyle style)
描述：
设置沉浸式材质对象的样式。该参数仅对高算力和中算力设备的显示效果有效，对低算力设备不生效但不会报错。可通过OH_ArkUI_NativeModule_GetGlobalMaterialLevel获取当前设备的材质等级以判断该参数是否生效。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 material为NULL时，返回错误码ARKUI_ERROR_CODE_PARAM_INVALID。 |
| ArkUI_ImmersiveStyle style | 材质样式。传入无效样式将导致设置失败，返回ARKUI_ERROR_CODE_PARAM_INVALID。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL或style无效），请确保传入有效的material指针和有效的style枚举值。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_GetStyle()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_GetStyle(ArkUI_ImmersiveMaterialHandle material, ArkUI_ImmersiveStyle* style)
描述：
获取沉浸式材质对象的样式。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 |
| ArkUI_ImmersiveStyle* style | 指向用于接收材质样式的变量的指针。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL或style为NULL），请确保material和style均为有效指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_SetMaterialColor()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_SetMaterialColor(ArkUI_ImmersiveMaterialHandle material, uint32_t color)
描述：
设置沉浸式材质对象的材质颜色。该参数对所有算力设备的显示效果有效。可通过OH_ArkUI_NativeModule_GetGlobalMaterialLevel获取当前设备的材质等级以判断该参数是否生效。如果不设置，默认值为0，表示透明色。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 material为NULL时，返回错误码ARKUI_ERROR_CODE_PARAM_INVALID。 |
| uint32_t color | 材质颜色，0xAARRGGBB格式，对所有算力设备的显示效果有效。传入0表示透明（默认值）。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL），请确保material为有效指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_GetMaterialColor()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_GetMaterialColor(ArkUI_ImmersiveMaterialHandle material, uint32_t* color)
描述：
获取沉浸式材质对象的材质颜色。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 |
| uint32_t* color | 指向用于接收0xAARRGGBB格式的材质颜色的变量的指针。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL或color为NULL），请确保material和color均为有效指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_SetApplyShadow()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_SetApplyShadow(ArkUI_ImmersiveMaterialHandle material, bool applyShadow)
描述：
设置沉浸式材质对象是否应用阴影。该参数对所有等级材质都生效。
当该参数为true时，材质中的阴影效果生效，优先于阴影通用属性。当该参数为false时，阴影通用属性生效，材质无阴影效果。如果不设置，默认值为true。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 |
| bool applyShadow | 是否添加材质效果的阴影。true表示材质阴影生效并优先于阴影通用属性，false表示不添加材质阴影、阴影通用属性生效。默认值为true。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL），请确保material为有效指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_GetApplyShadow()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_GetApplyShadow(ArkUI_ImmersiveMaterialHandle material, bool* applyShadow)
描述：
获取沉浸式材质对象是否应用阴影。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 |
| bool* applyShadow | 指向用于接收是否应用阴影的变量的指针。如果从未显式设置过该属性，该指针将接收默认值true。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL或applyShadow为NULL），请确保material和applyShadow均为有效指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_SetInteractive()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_SetInteractive(ArkUI_ImmersiveMaterialHandle material, bool interactive)
描述：
设置沉浸式材质对象是否可交互形变。即材质在用户交互（如触摸、按压）时是否产生视觉形变响应。该参数对所有等级材质都生效。
当该参数为true时，材质可交互形变。当该参数为false时，材质不可交互形变。如果不设置，遵循组件的行为。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 |
| bool interactive | 材质是否可交互形变。true表示材质可交互形变，false表示材质不可交互形变。如果不设置，遵循组件的行为。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL），请确保material为有效指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_GetInteractive()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_GetInteractive(ArkUI_ImmersiveMaterialHandle material, bool* interactive)
描述：
获取沉浸式材质对象的可交互形变属性。建议先通过OH_ArkUI_NativeModule_ImmersiveMaterial_SetInteractive设置该属性后再调用本接口获取，如果从未设置过该属性，函数将返回ARKUI_ERROR_CODE_PARAM_ERROR。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 material为NULL时，返回错误码ARKUI_ERROR_CODE_PARAM_INVALID。 |
| bool* interactive | 指向用于接收材质是否可交互形变的变量的指针。 interactive为NULL时，返回错误码ARKUI_ERROR_CODE_PARAM_INVALID。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL或interactive为NULL），请确保material和interactive均为有效指针。 ARKUI_ERROR_CODE_PARAM_ERROR 从未设置过该属性。请先调用OH_ArkUI_NativeModule_ImmersiveMaterial_SetInteractive设置该属性后再获取。 |
OH_ArkUI_NativeModule_LightEffectOptions_Create()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_LightEffectOptionsHandle OH_ArkUI_NativeModule_LightEffectOptions_Create()
描述：
创建光感交互效果配置对象，用于配置沉浸式材质的触摸高亮反馈效果。默认颜色为白色（0xffffffff）。创建完成后，需通过OH_ArkUI_NativeModule_ImmersiveMaterial_SetLightEffect将配置对象设置到沉浸式材质对象上才能生效。
起始版本： 26.0.0
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_LightEffectOptionsHandle | 返回指向创建的光感交互效果配置对象的指针。返回的对象使用完后需要通过OH_ArkUI_NativeModule_LightEffectOptions_Destroy释放。 |
OH_ArkUI_NativeModule_LightEffectOptions_Destroy()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
void OH_ArkUI_NativeModule_LightEffectOptions_Destroy(ArkUI_LightEffectOptionsHandle options)
描述：
销毁光感交互效果配置对象。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_LightEffectOptionsHandle options | 指向光感交互效果配置对象的指针。 |
OH_ArkUI_NativeModule_LightEffectOptions_SetColor()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_LightEffectOptions_SetColor(ArkUI_LightEffectOptionsHandle options, uint32_t color)
描述：
设置光感交互效果的颜色。如果不设置，默认颜色为白色（0xffffffff）。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_LightEffectOptionsHandle options | 指向光感交互效果配置对象的指针。 |
| uint32_t color | 光感交互效果颜色，0xAARRGGBB格式。如果不设置，默认颜色为白色（0xffffffff）。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（options为NULL），请确保options为有效指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_SetLightEffect()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_SetLightEffect(ArkUI_ImmersiveMaterialHandle material, const ArkUI_LightEffectOptionsHandle options)
描述：
设置沉浸式材质对象的光感交互效果，即在材质表面呈现随用户交互动态变化的光效反射。该参数对所有等级材质都生效。
传入NULL的光感交互效果配置指针表示禁用光感交互效果，适用于纯展示性材质表面场景；传入非NULL的光感交互效果配置指针表示使用该配置参数进行光感交互，适用于需要增强触摸视觉反馈的交互式组件场景。如果不调用该接口设置，光感交互效果遵循组件的行为。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 |
| const ArkUI_LightEffectOptionsHandle options | 指向光感交互效果配置对象的指针。传入NULL禁用光感交互效果，传入非NULL启用。非NULL指针需通过OH_ArkUI_NativeModule_LightEffectOptions_Create创建。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL），请确保material为有效指针。 |
OH_ArkUI_NativeModule_ImmersiveMaterial_GetLightEffectColor()
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
ArkUI_ErrorCode OH_ArkUI_NativeModule_ImmersiveMaterial_GetLightEffectColor(ArkUI_ImmersiveMaterialHandle material, uint32_t* color)
描述：
获取沉浸式材质对象的光感交互效果颜色。
只有在调用OH_ArkUI_NativeModule_ImmersiveMaterial_SetLightEffect成功设置非NULL的光感交互效果配置指针后，此接口才能成功获取颜色值。如果从未设置过光感交互效果或已禁用（传入NULL的光感交互效果配置指针），函数将返回ARKUI_ERROR_CODE_PARAM_ERROR。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| ArkUI_ImmersiveMaterialHandle material | 指向沉浸式材质对象的指针。 |
| uint32_t* color | 指向用于接收0xAARRGGBB格式的光感交互效果颜色的变量的指针。 |
返回：
| 类型 | 说明 |
|---|---|
| ArkUI_ErrorCode | ARKUI_ERROR_CODE_NO_ERROR 操作成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常（material为NULL或color为NULL），请确保material和color均为有效指针。 ARKUI_ERROR_CODE_PARAM_ERROR 光感交互效果从未设置或已禁用，请先调用OH_ArkUI_NativeModule_ImmersiveMaterial_SetLightEffect设置非NULL的光感交互效果配置指针后再获取颜色。 |
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词