更新3.3

docs/mcguide/18-界面与交互/19-控件属性动画.md

@@ -1,5 +1,5 @@
 ---
-front: 
+front:
 hard: 入门
 time: 分钟
 ---
@@ -14,6 +14,8 @@ MC为部分UI控件属性提供了一套属性动画逻辑，活用他们，可
 
 以下所有属性动画的示例均可参考 UIDemoModUI 动画演示，demo的下载位置见[这里](../20-玩法开发/13-模组SDK编程/60-Demo示例.md)。
 
+另外，这里还会介绍如何通过接口去控制你的动画。
+
 ## Demo介绍
 
 将上述的 UIDemoModUI 导入Studio，并使用编辑器打开。
@@ -184,7 +186,7 @@ uv动画和序列帧动画都是uv起点属性的动画，不同于其他属性
 
 要表现一个属性动画，需要先写一个Json数据块，透明度动画举例如下（相关参数会在下文详细描述）：
 
-```json 
+```json
   {
       "anim_type" : "alpha",
       "duration" : 1.0,
@@ -197,7 +199,7 @@ uv动画和序列帧动画都是uv起点属性的动画，不同于其他属性
 
 一种是将Json数据块直接赋给alpha属性：
 
-```json 
+```json
   {
         "alphaImg" : {
             "alpha" : {
@@ -215,7 +217,7 @@ uv动画和序列帧动画都是uv起点属性的动画，不同于其他属性
 
 另一种则是将属性动画写成自定义控件的形式写在UIjson文件的最外层，在alpha属性值以 “@”+动画名 的形式进行赋值：
 
-```json 
+```json
   {
         "alphaImg" : {
             "alpha" : "@show_alpha_ani",
@@ -525,3 +527,37 @@ uv动画和序列帧动画都是uv起点属性的动画，不同于其他属性
         },
 
 ```
+
+
+## 控制动画
+
+
+目前的SDK接口支持注册动画，给属性添加动画，移除属性的动画，暂停播放单一（或者全部）属性动画等等，开发者可以参考以下的接口：
+
+注册动画： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#registeruianimations">RegisterUIAnimations</a>
+
+取消注册动画： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#unregisteruianimation">UnregisterUIAnimation</a>
+
+
+暂停动画： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI控件.html#pauseanimation">PauseAnimation</a>
+
+播放动画： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI控件.html#playanimation">PlayAnimation</a>
+
+停止播放动画： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI控件.html#stopanimation">StopAnimation</a>
+
+
+给单一属性设置动画： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI控件.html#setanimation">SetAnimation</a>
+
+
+给单一属性移除动画： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI控件.html#removeanimation">RemoveAnimation</a>
+
+
+设置动画播放结束后的回调： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI控件.html#setanimendcallback">SetAnimEndCallback</a>
+
+
+删除回调： <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI控件.html#removeanimendcallback">RemoveAnimEndCallback</a>
+
+
+这些接口在 UIDemoModUI 中部分使用（注册和添加动画请点击 "无动画按钮"）
+
+![添加动画](./picture/UIAnimation/normal.png)