Star983
6251
代码
代码
Issues1511
Pull Requests1556
项目讨论
Wiki
分析
Star983
6251
已合并
animation group docs #164835
hehongyang3创建于 9月16日
animation group docs #164835
已合并
hehongyang3创建于 9月16日
从hehongyang3/docsanimationGroup合入到openharmony/docsmaster
共 9 个文件变更+2884-9
Mzh-cn/application-dev/reference/apis-arkui/Readme-CN.md+5-0
@@ -779,6 +779,10 @@
779 - [ArkUI_AnimatorEvent](capi-arkui-nativemodule-arkui-animatorevent.md)779 - [ArkUI_AnimatorEvent](capi-arkui-nativemodule-arkui-animatorevent.md)
780 - [ArkUI_AnimatorOnFrameEvent](capi-arkui-nativemodule-arkui-animatoronframeevent.md)780 - [ArkUI_AnimatorOnFrameEvent](capi-arkui-nativemodule-arkui-animatoronframeevent.md)
781 - [ArkUI_TransitionEffect](capi-arkui-nativemodule-arkui-transitioneffect.md)781 - [ArkUI_TransitionEffect](capi-arkui-nativemodule-arkui-transitioneffect.md)
782+ - [OH_ArkUI_PropertyAnimation*](capi-arkui-nativemodule-arkui-propertyanimation8h.md)
783+ - [OH_ArkUI_KeyframeAnimation*](capi-arkui-nativemodule-arkui-keyframeanimation8h.md)
784+ - [OH_ArkUI_PathAnimation*](capi-arkui-nativemodule-arkui-pathanimation8h.md)
785+ - [OH_ArkUI_AnimationGroup*](capi-arkui-nativemodule-arkui-animationgroup8h.md)
782 - [ArkUI_NativeDialogAPI_1](capi-arkui-nativemodule-arkui-nativedialogapi-1.md)786 - [ArkUI_NativeDialogAPI_1](capi-arkui-nativemodule-arkui-nativedialogapi-1.md)
783 - [ArkUI_NativeDialogAPI_2](capi-arkui-nativemodule-arkui-nativedialogapi-2.md)787 - [ArkUI_NativeDialogAPI_2](capi-arkui-nativemodule-arkui-nativedialogapi-2.md)
784 - [ArkUI_NativeDialogAPI_3](capi-arkui-nativemodule-arkui-nativedialogapi-3.md)788 - [ArkUI_NativeDialogAPI_3](capi-arkui-nativemodule-arkui-nativedialogapi-3.md)
@@ -1013,6 +1017,7 @@
1013 - [DrawableDescriptor错误码](errorcode-drawable-descriptor.md)1017 - [DrawableDescriptor错误码](errorcode-drawable-descriptor.md)
1014 - [环境变量错误码](errorcode-env.md)1018 - [环境变量错误码](errorcode-env.md)
1015 - [反色能力错误码](errorcode-force-dark.md)1019 - [反色能力错误码](errorcode-force-dark.md)
1020+ - [动视效错误码](errorcode-animation.md)
1016 - 图形图像<!--arkui-graphics-images-arkts-errcode-->1021 - 图形图像<!--arkui-graphics-images-arkts-errcode-->
1017 - [屏幕错误码](errorcode-display.md)1022 - [屏幕错误码](errorcode-display.md)
1018 - [窗口错误码](errorcode-window.md)1023 - [窗口错误码](errorcode-window.md)
Azh-cn/application-dev/reference/apis-arkui/capi-arkui-nativemodule-arkui-animationgroup8h.md+21-0
@@ -0,0 +1,21 @@
1+# OH_ArkUI_AnimationGroup*
liujingliujing
liujingliujing9月20日

新增文档需要在readme里添加目录，统一补充。

likedislike
H
hehongyang3
9月20日 评论：
liujingliujing9月20日

这个名称应该是OH_ArkUI_AnimationGroup吧？请确认。

likedislike
H
hehongyang3
9月20日 评论：
2+<!--Kit: ArkUI-->
3+<!--Subsystem: ArkUI-->
4+<!--Owner: @hehongyang3-->
5+<!--Designer: @hehongyang3-->
6+<!--Tester: @lxl007-->
7+<!--Adviser: @Brilliantry_Rui-->
8+ 
9+```c
10+typedef struct OH_ArkUI_AnimationGroup *OH_ArkUI_AnimationGroupHandle
11+```
12+ 
13+## 概述
14+ 
15+定义动画组的句柄。
16+ 
17+**起始版本：** 26.0.1
18+ 
19+**相关模块：** [ArkUI_NativeModule](capi-arkui-nativemodule.md)
20+ 
21+**所在头文件：** [native_animate.h](capi-native-animate-h.md)
Mzh-cn/application-dev/reference/apis-arkui/capi-arkui-nativemodule-arkui-error-code-h.md+5-0
@@ -70,6 +70,11 @@ enum ArkUI_ErrorCode
70| ARKUI_ERROR_CODE_NODE_CAN_NOT_BE_ADOPTED = 106208 | 节点无法被接纳为附属节点。错误码的详细介绍请参见[106208 节点无法被接纳为附属节点](errorcode-adopt.md#106208-节点无法被接纳为附属节点)。<br>**起始版本：** 22 |70| ARKUI_ERROR_CODE_NODE_CAN_NOT_BE_ADOPTED = 106208 | 节点无法被接纳为附属节点。错误码的详细介绍请参见[106208 节点无法被接纳为附属节点](errorcode-adopt.md#106208-节点无法被接纳为附属节点)。<br>**起始版本：** 22 |
71| ARKUI_ERROR_CODE_NODE_CAN_NOT_ADOPT_TO = 106209 | 节点无法接纳其他节点。错误码的详细介绍请参见[106209 节点无法接纳其他节点](errorcode-adopt.md#106209-节点无法接纳其他节点)。<br>**起始版本：** 22 |71| ARKUI_ERROR_CODE_NODE_CAN_NOT_ADOPT_TO = 106209 | 节点无法接纳其他节点。错误码的详细介绍请参见[106209 节点无法接纳其他节点](errorcode-adopt.md#106209-节点无法接纳其他节点)。<br>**起始版本：** 22 |
72| ARKUI_ERROR_CODE_NODE_IS_NOT_IN_ADOPTED_CHILDREN = 106210 | 节点不是被目标节点接纳的附属节点。错误码的详细介绍请参见[106210 节点不是被父节点接纳的附属节点](errorcode-adopt.md#106210-节点不是被父节点接纳的附属节点)。<br>**起始版本：** 22 |72| ARKUI_ERROR_CODE_NODE_IS_NOT_IN_ADOPTED_CHILDREN = 106210 | 节点不是被目标节点接纳的附属节点。错误码的详细介绍请参见[106210 节点不是被父节点接纳的附属节点](errorcode-adopt.md#106210-节点不是被父节点接纳的附属节点)。<br>**起始版本：** 22 |
73+| ARKUI_ERROR_CODE_NO_ATTRIBUTE_FOUND = 106211 | 无法获取属性，因为之前未设置该属性。错误码的详细介绍请参见[106211 无法获取属性](errorcode-animation.md#106211-无法获取属性)。<br>**起始版本：** 26.0.1 |
74+| ARKUI_ERROR_CODE_SUB_ANIMATION_INVALID = 106212 | 子动画参数无效。错误码的详细介绍请参见[106212 子动画参数无效](errorcode-animation.md#106212-子动画参数无效)。<br>**起始版本：** 26.0.1 |
75+| ARKUI_ERROR_CODE_ANIMATION_GROUP_NOT_FOUND = 106213 | 在[ArkUI_ContextHandle](capi-arkui-nativemodule-arkui-context8h.md)上未找到指定的动画组。错误码的详细介绍请参见[106213 在UIContext上未找到指定的动画组](errorcode-animation.md#106213-在uicontext上未找到指定的动画组)。<br>**起始版本：** 26.0.1 |
76+| ARKUI_ERROR_CODE_ANIMATION_GROUP_REENTRANT_CALL = 106214 | 检测到同一线程上对动画组接口的重入调用。错误码的详细介绍请参见[106214 检测到同一线程上对动画组接口的重入调用](errorcode-animation.md#106214-检测到同一线程上对动画组接口的重入调用)。<br>**起始版本：** 26.0.1 |
77+| ARKUI_ERROR_CODE_ANIMATION_GROUP_INVALID_STATE = 106215 | 动画组未处于操作所需的状态。错误码的详细介绍请参见[106215 动画组未处于操作所需的状态](errorcode-animation.md#106215-动画组未处于操作所需的状态)。<br>**起始版本：** 26.0.1 |
73| ARKUI_ERROR_CODE_NOT_CUSTOM_NODE = 106401 | 当前节点不是自定义节点。错误码的详细介绍请参见[渲染节点错误码](errorcode-node-render.md)。<br>**起始版本：** 20 |78| ARKUI_ERROR_CODE_NOT_CUSTOM_NODE = 106401 | 当前节点不是自定义节点。错误码的详细介绍请参见[渲染节点错误码](errorcode-node-render.md)。<br>**起始版本：** 20 |
74| ARKUI_ERROR_CODE_CHILD_EXISTED = 106402 | 当前节点已存在子节点。错误码的详细介绍请参见[渲染节点错误码](errorcode-node-render.md)。<br>**起始版本：** 20 |79| ARKUI_ERROR_CODE_CHILD_EXISTED = 106402 | 当前节点已存在子节点。错误码的详细介绍请参见[渲染节点错误码](errorcode-node-render.md)。<br>**起始版本：** 20 |
75| ARKUI_ERROR_CODE_RENDER_PARENT_EXISTED = 106403 | 当前渲染节点存在父节点。错误码的详细介绍请参见[渲染节点错误码](errorcode-node-render.md)。<br>**起始版本：** 20 |80| ARKUI_ERROR_CODE_RENDER_PARENT_EXISTED = 106403 | 当前渲染节点存在父节点。错误码的详细介绍请参见[渲染节点错误码](errorcode-node-render.md)。<br>**起始版本：** 20 |
Azh-cn/application-dev/reference/apis-arkui/capi-arkui-nativemodule-arkui-keyframeanimation8h.md+21-0
@@ -0,0 +1,21 @@
1+# OH_ArkUI_KeyframeAnimation*
2+<!--Kit: ArkUI-->
3+<!--Subsystem: ArkUI-->
4+<!--Owner: @hehongyang3-->
5+<!--Designer: @hehongyang3-->
6+<!--Tester: @lxl007-->
7+<!--Adviser: @Brilliantry_Rui-->
8+ 
9+```c
10+typedef struct OH_ArkUI_KeyframeAnimation *OH_ArkUI_KeyframeAnimationHandle
11+```
12+ 
13+## 概述
14+ 
15+定义关键帧动画的句柄。
16+ 
17+**起始版本：** 26.0.1
18+ 
19+**相关模块：** [ArkUI_NativeModule](capi-arkui-nativemodule.md)
20+ 
21+**所在头文件：** [native_animate.h](capi-native-animate-h.md)
Azh-cn/application-dev/reference/apis-arkui/capi-arkui-nativemodule-arkui-pathanimation8h.md+21-0
@@ -0,0 +1,21 @@
1+# OH_ArkUI_PathAnimation*
liujing
liujingliujing9月20日

确认结构体名称。

likedislike
H
hehongyang3
9月20日 评论：
2+<!--Kit: ArkUI-->
3+<!--Subsystem: ArkUI-->
4+<!--Owner: @hehongyang3-->
5+<!--Designer: @hehongyang3-->
6+<!--Tester: @lxl007-->
7+<!--Adviser: @Brilliantry_Rui-->
8+ 
9+```c
10+typedef struct OH_ArkUI_PathAnimation *OH_ArkUI_PathAnimationHandle
11+```
12+ 
13+## 概述
14+ 
15+定义路径动画的句柄。
16+ 
17+**起始版本：** 26.0.1
18+ 
19+**相关模块：** [ArkUI_NativeModule](capi-arkui-nativemodule.md)
20+ 
21+**所在头文件：** [native_animate.h](capi-native-animate-h.md)
Azh-cn/application-dev/reference/apis-arkui/capi-arkui-nativemodule-arkui-propertyanimation8h.md+21-0
@@ -0,0 +1,21 @@
1+# OH_ArkUI_PropertyAnimation*
2+<!--Kit: ArkUI-->
3+<!--Subsystem: ArkUI-->
4+<!--Owner: @hehongyang3-->
5+<!--Designer: @hehongyang3-->
6+<!--Tester: @lxl007-->
7+<!--Adviser: @Brilliantry_Rui-->
8+ 
9+```c
10+typedef struct OH_ArkUI_PropertyAnimation *OH_ArkUI_PropertyAnimationHandle
11+```
12+ 
13+## 概述
14+ 
15+定义属性动画的句柄。
16+ 
17+**起始版本：** 26.0.1
18+ 
19+**相关模块：** [ArkUI_NativeModule](capi-arkui-nativemodule.md)
20+ 
21+**所在头文件：** [native_animate.h](capi-native-animate-h.md)
Mzh-cn/application-dev/reference/apis-arkui/capi-native-type-visual-h.md+75-0
@@ -59,6 +59,9 @@
59| [ArkUI_RenderFit](#arkui_renderfit) | ArkUI_RenderFit | 定义动画终态内容大小与位置的枚举值。 |59| [ArkUI_RenderFit](#arkui_renderfit) | ArkUI_RenderFit | 定义动画终态内容大小与位置的枚举值。 |
60| [ArkUI_AnimationDirection](#arkui_animationdirection) | ArkUI_AnimationDirection | 动画播放方向。 |60| [ArkUI_AnimationDirection](#arkui_animationdirection) | ArkUI_AnimationDirection | 动画播放方向。 |
61| [ArkUI_AnimationFillMode](#arkui_animationfillmode) | ArkUI_AnimationFillMode | 定义帧动画组件在动画开始前和结束后的状态。 |61| [ArkUI_AnimationFillMode](#arkui_animationfillmode) | ArkUI_AnimationFillMode | 定义帧动画组件在动画开始前和结束后的状态。 |
62+| [OH_ArkUI_AnimationPropertyType](#oh_arkui_animationpropertytype) | OH_ArkUI_AnimationPropertyType | 枚举属性动画、关键帧动画和路径动画的可动画属性类型。 |
63+| [OH_ArkUI_AnimationGroupState](#oh_arkui_animationgroupstate) | OH_ArkUI_AnimationGroupState | 枚举动画组的播放状态。 |
64+| [OH_ArkUI_AnimationFinishMode](#oh_arkui_animationfinishmode) | OH_ArkUI_AnimationFinishMode | 枚举动画组的结束模式。 |
62 65 
63### 函数66### 函数
64 67 
@@ -553,6 +556,78 @@ enum ArkUI_AnimationFillMode
553| ARKUI_ANIMATION_FILL_MODE_BACKWARDS = 2 | 动画将在应用于目标时立即应用第一个关键帧中定义的值，并在[delay](capi-native-animate-h.md#oh_arkui_animateoption_setdelay)期间保留此值。 |556| ARKUI_ANIMATION_FILL_MODE_BACKWARDS = 2 | 动画将在应用于目标时立即应用第一个关键帧中定义的值，并在[delay](capi-native-animate-h.md#oh_arkui_animateoption_setdelay)期间保留此值。 |
554| ARKUI_ANIMATION_FILL_MODE_BOTH = 3 | 动画将遵循[ARKUI_ANIMATION_FILL_MODE_FORWARDS](#arkui_animationfillmode)和[ARKUI_ANIMATION_FILL_MODE_BACKWARDS](#arkui_animationfillmode)的规则，从而在两个方向上扩展动画属性。 |557| ARKUI_ANIMATION_FILL_MODE_BOTH = 3 | 动画将遵循[ARKUI_ANIMATION_FILL_MODE_FORWARDS](#arkui_animationfillmode)和[ARKUI_ANIMATION_FILL_MODE_BACKWARDS](#arkui_animationfillmode)的规则，从而在两个方向上扩展动画属性。 |
555 558 
559+### OH_ArkUI_AnimationPropertyType
liujing
liujingliujing9月20日

上边的枚举表格里也需要同步添加这些新增枚举。 image.png

likedislike
H
hehongyang3
9月20日 评论：
560+ 
561+```c
562+enum OH_ArkUI_AnimationPropertyType
563+```
564+ 
565+**描述：**
566+ 
567+ 
568+枚举属性动画、关键帧动画和路径动画的可动画属性类型。
刘睿
刘睿刘睿9月21日

需要补充value的介绍

likedislike
569+ 
570+**起始版本：** 26.0.1
571+ 
572+| 枚举项 | 描述 |
573+| -- | -- |
574+| OH_ARKUI_ANIMATION_PROPERTY_TRANSLATION = 0 | 在x和y方向上的平移。设置或获取该属性值时，需要两个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，依次为x、y方向的平移量，单位为px。 |
575+| OH_ARKUI_ANIMATION_PROPERTY_TRANSLATION_X = 1 | 在x方向上的平移。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为px。 |
576+| OH_ARKUI_ANIMATION_PROPERTY_TRANSLATION_Y = 2 | 在y方向上的平移。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为px。 |
577+| OH_ARKUI_ANIMATION_PROPERTY_TRANSLATION_Z = 3 | 在z方向上的平移。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为px。 |
578+| OH_ARKUI_ANIMATION_PROPERTY_SCALE = 4 | 在x和y方向上的缩放。设置或获取该属性值时，需要两个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，依次为x、y方向的缩放比例。 |
579+| OH_ARKUI_ANIMATION_PROPERTY_SCALE_X = 5 | 在x方向上的缩放。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素。 |
580+| OH_ARKUI_ANIMATION_PROPERTY_SCALE_Y = 6 | 在y方向上的缩放。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素。 |
581+| OH_ARKUI_ANIMATION_PROPERTY_ROTATION = 7 | 所有轴的旋转角度。设置或获取该属性值时，需要三个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，依次为x、y、z轴的旋转角度，单位为度。 |
582+| OH_ARKUI_ANIMATION_PROPERTY_ROTATION_X = 8 | 围绕x轴的旋转角度。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为度。 |
583+| OH_ARKUI_ANIMATION_PROPERTY_ROTATION_Y = 9 | 围绕y轴的旋转角度。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为度。 |
584+| OH_ARKUI_ANIMATION_PROPERTY_ROTATION_Z = 10 | 围绕z轴的旋转角度。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为度。 |
585+| OH_ARKUI_ANIMATION_PROPERTY_OPACITY = 11 | 组件的不透明度。设置或获取该属性值时，需要一个f32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素。取值范围：[0, 1]。 |
586+| OH_ARKUI_ANIMATION_PROPERTY_BOUNDS = 12 | 边界（位置和大小）。设置或获取该属性值时，需要四个i32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，依次为x坐标、y坐标、宽度、高度，单位为px。其中宽度和高度的取值范围为大于等于0。 |
587+| OH_ARKUI_ANIMATION_PROPERTY_BOUNDS_X = 13 | 边界左上角的x坐标位置。设置或获取该属性值时，需要一个i32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为px。 |
588+| OH_ARKUI_ANIMATION_PROPERTY_BOUNDS_Y = 14 | 边界左上角的y坐标位置。设置或获取该属性值时，需要一个i32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为px。 |
589+| OH_ARKUI_ANIMATION_PROPERTY_BOUNDS_WIDTH = 15 | 边界的宽度。设置或获取该属性值时，需要一个i32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为px。取值范围为大于等于0。 |
590+| OH_ARKUI_ANIMATION_PROPERTY_BOUNDS_HEIGHT = 16 | 边界的高度。设置或获取该属性值时，需要一个i32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素，单位为px。取值范围为大于等于0。 |
591+| OH_ARKUI_ANIMATION_PROPERTY_BACKGROUND_COLOR = 17 | 组件的背景颜色。设置或获取该属性值时，需要一个u32类型的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)元素。 |
592+ 
593+### OH_ArkUI_AnimationGroupState
594+ 
595+```c
596+enum OH_ArkUI_AnimationGroupState
597+```
598+ 
599+**描述：**
600+ 
601+ 
602+枚举动画组的播放状态。
603+ 
604+**起始版本：** 26.0.1
605+ 
606+| 枚举项 | 描述 |
607+| -- | -- |
608+| OH_ARKUI_ANIMATION_GROUP_STATE_RUNNING = 0 | 动画组正在运行。 |
609+| OH_ARKUI_ANIMATION_GROUP_STATE_PAUSED = 1 | 动画组已暂停。 |
610+| OH_ARKUI_ANIMATION_GROUP_STATE_INACTIVE = 2 | 动画组处于非活动状态，例如动画已结束或动画组处于无效状态。 |
611+ 
612+### OH_ArkUI_AnimationFinishMode
613+ 
614+```c
615+enum OH_ArkUI_AnimationFinishMode
616+```
617+ 
618+**描述：**
619+ 
620+ 
621+枚举动画组的结束模式。
622+ 
623+**起始版本：** 26.0.1
624+ 
625+| 枚举项 | 描述 |
626+| -- | -- |
627+| OH_ARKUI_ANIMATION_FINISH_TO_START = 0 | 结束动画组并跳转到起始状态。 |
628+| OH_ARKUI_ANIMATION_FINISH_TO_CURRENT = 1 | 结束动画组并保持在当前值。 |
629+| OH_ARKUI_ANIMATION_FINISH_TO_END = 2 | 结束动画组并跳转到结束状态。 |
630+ 
556## 函数说明631## 函数说明
557 632 
558### OH_ArkUI_Matrix4_CreateIdentity()633### OH_ArkUI_Matrix4_CreateIdentity()
Azh-cn/application-dev/reference/apis-arkui/errorcode-animation.md+108-0
@@ -0,0 +1,108 @@
1+# 动视效错误码
2+<!--Kit: ArkUI-->
3+<!--Subsystem: ArkUI-->
4+<!--Owner: @hehongyang3-->
5+<!--Designer: @hehongyang3-->
6+<!--Tester: @lxl007-->
7+<!--Adviser: @Brilliantry_Rui-->
8+ 
9+> **说明：**
10+>
11+> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码](../errorcode-universal.md)。
12+ 
13+## 106211 无法获取属性
14+ 
15+**错误信息**
16+ 
17+The attribute was not found because it was not set before.
18+ 
19+**错误描述**
20+ 
21+无法获取属性，因为之前未设置该属性。
22+ 
23+**可能原因**
24+ 
25+调用接口获取属性值时，之前未通过对应的设置接口设置该属性。例如调用[OH_ArkUI_NativeModule_PropertyAnimation_GetFromValue](capi-native-animate-h.md#oh_arkui_nativemodule_propertyanimation_getfromvalue)时，之前未通过[OH_ArkUI_NativeModule_PropertyAnimation_SetFromValue](capi-native-animate-h.md#oh_arkui_nativemodule_propertyanimation_setfromvalue)设置属性值。
26+ 
27+**处理步骤**
28+ 
29+先通过对应的设置接口设置属性值，再调用接口获取属性值。
30+ 
31+## 106212 子动画参数无效
32+ 
33+**错误信息**
34+ 
35+The sub-animation parameter is invalid.
36+ 
37+**错误描述**
38+ 
39+添加到动画组的子动画参数无效。
40+ 
41+**可能原因**
42+ 
43+1. 通过[OH_ArkUI_NativeModule_AnimationGroup_AddPropertyAnimation](capi-native-animate-h.md#oh_arkui_nativemodule_animationgroup_addpropertyanimation)添加属性动画时：属性动画未设置结束值（未调用[OH_ArkUI_NativeModule_PropertyAnimation_SetToValue](capi-native-animate-h.md#oh_arkui_nativemodule_propertyanimation_settovalue)）。
44+2. 通过[OH_ArkUI_NativeModule_AnimationGroup_AddKeyframeAnimation](capi-native-animate-h.md#oh_arkui_nativemodule_animationgroup_addkeyframeanimation)添加关键帧动画时：关键帧时间点顺序不正确（存在后续关键帧时间点小于前一个关键帧时间点的情况），或未通过[OH_ArkUI_NativeModule_KeyframeAnimation_SetValue](capi-native-animate-h.md#oh_arkui_nativemodule_keyframeanimation_setvalue)或[OH_ArkUI_NativeModule_KeyframeAnimation_SetValues](capi-native-animate-h.md#oh_arkui_nativemodule_keyframeanimation_setvalues)完整设置与创建关键帧动画时传入的[propertyType](capi-native-animate-h.md#oh_arkui_nativemodule_keyframeanimation_create)对应的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)值。
45+3. 通过[OH_ArkUI_NativeModule_AddAnimationGroup](capi-native-animate-h.md#oh_arkui_nativemodule_addanimationgroup)注册动画组时：子动画未设置目标渲染节点，且动画组也未设置默认目标渲染节点，导致无法解析出目标节点。
46+ 
47+**处理步骤**
48+ 
49+1. 确保属性动画已通过[OH_ArkUI_NativeModule_PropertyAnimation_SetToValue](capi-native-animate-h.md#oh_arkui_nativemodule_propertyanimation_settovalue)设置结束值。
50+2. 确保关键帧动画已通过[OH_ArkUI_NativeModule_KeyframeAnimation_SetValue](capi-native-animate-h.md#oh_arkui_nativemodule_keyframeanimation_setvalue)或[OH_ArkUI_NativeModule_KeyframeAnimation_SetValues](capi-native-animate-h.md#oh_arkui_nativemodule_keyframeanimation_setvalues)为每个关键帧设置与propertyType对应的[ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)值；通过[OH_ArkUI_NativeModule_KeyframeAnimation_SetKeyTime](capi-native-animate-h.md#oh_arkui_nativemodule_keyframeanimation_setkeytime)设置关键帧时间点时，需确保关键帧时间点顺序正确（后续关键帧时间点不小于前一个关键帧时间点）。
51+3. 通过[OH_ArkUI_NativeModule_PropertyAnimation_SetTargetNode](capi-native-animate-h.md#oh_arkui_nativemodule_propertyanimation_settargetnode)、[OH_ArkUI_NativeModule_KeyframeAnimation_SetTargetNode](capi-native-animate-h.md#oh_arkui_nativemodule_keyframeanimation_settargetnode)或[OH_ArkUI_NativeModule_PathAnimation_SetTargetNode](capi-native-animate-h.md#oh_arkui_nativemodule_pathanimation_settargetnode)为子动画设置目标渲染节点，或通过[OH_ArkUI_NativeModule_AnimationGroup_SetTargetNode](capi-native-animate-h.md#oh_arkui_nativemodule_animationgroup_settargetnode)设置动画组的默认目标渲染节点。
52+ 
53+## 106213 在UIContext上未找到指定的动画组
54+ 
55+**错误信息**
56+ 
57+The animation group is not found on the UIContext.
58+ 
59+**错误描述**
60+ 
61+在UIContext上未找到指定key标识的动画组。
62+ 
63+**可能原因**
64+ 
65+1. 使用未通过[OH_ArkUI_NativeModule_AddAnimationGroup](capi-native-animate-h.md#oh_arkui_nativemodule_addanimationgroup)注册的key查找动画组。
66+2. 动画组已结束播放，动画结束后被系统自动移除。
67+ 
68+**处理步骤**
69+ 
70+确认key已通过[OH_ArkUI_NativeModule_AddAnimationGroup](capi-native-animate-h.md#oh_arkui_nativemodule_addanimationgroup)注册，且动画组尚未结束。动画组在自然结束、调用[OH_ArkUI_NativeModule_FinishAnimationGroup](capi-native-animate-h.md#oh_arkui_nativemodule_finishanimationgroup)或目标节点销毁后，会触发动画结束回调，回调执行完毕后系统自动移除动画组。必要时通过[OH_ArkUI_NativeModule_HasAnimationGroup](capi-native-animate-h.md#oh_arkui_nativemodule_hasanimationgroup)检查动画组是否存在。
71+ 
72+## 106214 检测到同一线程上对动画组接口的重入调用
73+ 
74+**错误信息**
75+ 
76+A re-entrant call to animation group APIs is detected on the same thread.
77+ 
78+**错误描述**
79+ 
80+在同一线程上，一个动画组接口调用尚未返回时，该线程嵌套调用了另一个动画组接口。
81+ 
82+**可能原因**
83+ 
84+在同一线程上，一个动画组接口调用尚未返回时，该线程嵌套调用了另一个动画组接口。
85+ 
86+**处理步骤**
87+ 
88+确保动画组接口在上一调用完全返回后再进行下一次调用，避免在同一线程上嵌套调用动画组接口。
89+ 
90+## 106215 动画组未处于操作所需的状态
91+ 
92+**错误信息**
93+ 
94+The animation group is not in the required state for the operation.
95+ 
96+**错误描述**
97+ 
98+动画组当前状态不满足接口调用所需的状态要求。
99+ 
100+**可能原因**
101+ 
102+1. 调用[OH_ArkUI_NativeModule_PauseAnimationGroup](capi-native-animate-h.md#oh_arkui_nativemodule_pauseanimationgroup)时动画组不处于[OH_ARKUI_ANIMATION_GROUP_STATE_RUNNING](capi-native-type-visual-h.md#oh_arkui_animationgroupstate)状态。
103+2. 调用[OH_ArkUI_NativeModule_ResumeAnimationGroup](capi-native-animate-h.md#oh_arkui_nativemodule_resumeanimationgroup)时动画组不处于[OH_ARKUI_ANIMATION_GROUP_STATE_PAUSED](capi-native-type-visual-h.md#oh_arkui_animationgroupstate)状态。
104+3. 调用[OH_ArkUI_NativeModule_FinishAnimationGroup](capi-native-animate-h.md#oh_arkui_nativemodule_finishanimationgroup)时动画组不处于[OH_ARKUI_ANIMATION_GROUP_STATE_RUNNING](capi-native-type-visual-h.md#oh_arkui_animationgroupstate)或[OH_ARKUI_ANIMATION_GROUP_STATE_PAUSED](capi-native-type-visual-h.md#oh_arkui_animationgroupstate)状态。
105+ 
106+**处理步骤**
107+ 
108+通过[OH_ArkUI_NativeModule_GetAnimationGroupState](capi-native-animate-h.md#oh_arkui_nativemodule_getanimationgroupstate)查询动画组当前状态，确保状态正确后再调用对应接口。