OpenHarmony動畫詳解

簡介

動畫是組件的基礎(chǔ)特性之一,精心設(shè)計的動畫使 UI 變化更直觀,平滑的動畫效果能夠很好地增強差異性功能的過渡鳖孤,有助于改進應(yīng)用程序的外觀并改善用戶體驗。

OpenHarmony 動畫分類:

  • 屬性動畫:組件的某些通用屬性變化時抡笼,可以通過屬性動畫實現(xiàn)漸變過渡效果苏揣,提升用戶體驗。支持的屬性包括 width推姻、height平匈、backgroundColor、opacity藏古、scale增炭、rotate、translate 等校翔。
  • 顯示動畫:提供全局 animateTo 顯式動畫接口來指定由于閉包代碼導(dǎo)致的狀態(tài)變化插入過渡動效弟跑。
  • 轉(zhuǎn)場動畫
    • 頁面間轉(zhuǎn)場:在全局 pageTransition 方法內(nèi)配置頁面入場和頁面退場時的自定義轉(zhuǎn)場動效。
    • 組件內(nèi)轉(zhuǎn)場:組件內(nèi)轉(zhuǎn)場主要通過 transition 屬性配置轉(zhuǎn)場參數(shù)防症,在組件插入和刪除時顯示過渡動效孟辑,主要用于容器組件中的子組件插入和刪除時,提升用戶體驗(需要配合animateTo 才能生效蔫敲,動效時長饲嗽、曲線、延時跟隨 animateTo 中的配置)奈嘿。
    • 共享元素轉(zhuǎn)場:設(shè)置頁面間轉(zhuǎn)場時共享元素的轉(zhuǎn)場動效貌虾。
  • 路徑動畫:設(shè)置組件進行位移動畫時的運動路徑。
  • 窗口動畫:提供啟動退出過程中控件動畫和應(yīng)用窗口聯(lián)動動畫能力裙犹。

動畫詳解

屬性動畫

通過控件的 animation 屬性實現(xiàn)動畫效果尽狠。

animation(value: {duration?: number, tempo?: number, curve?: string | Curve | ICurve, delay?:number, iterations: number, playMode?: PlayMode, onFinish?: () => void})

參數(shù) 類型 必填 描述
duration number 設(shè)置動畫時長。單位為毫秒叶圃,默認動畫時長為 1000 毫秒袄膏。 默認值:1000
tempo number 動畫播放速度。數(shù)值越大掺冠,動畫播放速度越快沉馆,數(shù)值越小,播放速度越慢 值為 0 時,表示不存在動畫斥黑。 默認值:1
curve string Curve ICurve9+
delay number 設(shè)置動畫延遲執(zhí)行的時長揖盘。單位為毫秒,默認不延時播放锌奴。 默認值:0
iterations number 設(shè)置播放次數(shù)兽狭。默認播放一次,設(shè)置為-1 時表示無限次播放缨叫。 默認值:1
playMode PlayMode 設(shè)置動畫播放模式椭符,默認播放完成后重頭開始播放。 默認值:PlayMode.Normal
onFinish () => void 狀態(tài)回調(diào)耻姥,動畫播放完成時觸發(fā)。

示例

// xxx.ets
@Entry
@Component
struct AnimateToExample {
  @State widthSize: number = 250
  @State heightSize: number = 100
  @State rotateAngle: number = 0
  private flag: boolean = true

  build() {
    Column() {
      Button('change width and height')
        .width(this.widthSize)
        .height(this.heightSize)
        .margin(30)
        .onClick(() => {
          if (this.flag) {
            animateTo({
              duration: 2000,
              curve: Curve.EaseOut,
              iterations: 3,
              playMode: PlayMode.Normal,
              onFinish: () => {
                console.info('play end')
              }
            }, () => {
              this.widthSize = 100
              this.heightSize = 50
            })
          } else {
            animateTo({}, () => {
              this.widthSize = 250
              this.heightSize = 100
            })
          }
          this.flag = !this.flag
        })
      Button('change rotate angle')
        .margin(50)
        .rotate({ angle: this.rotateAngle })
        .onClick(() => {
          animateTo({
            duration: 1200,
            curve: Curve.Friction,
            delay: 500,
            iterations: -1, // 設(shè)置-1表示動畫無限循環(huán)
            playMode: PlayMode.AlternateReverse,
            onFinish: () => {
              console.info('play end')
            }
          }, () => {
            this.rotateAngle = 90
          })
        })
    }.width('100%').margin({ top: 5 })
  }
}

顯示動畫

通過全局 animateTo 顯式動畫接口來定由于閉包代碼導(dǎo)致的狀態(tài)變化插入過渡動效有咨。

animateTo(value: AnimateParam, event: () => void): void

參數(shù) 類型 是否必填 描述
value AnimateParam 設(shè)置動畫效果相關(guān)參數(shù)琐簇。
event () => void 指定顯示動效的閉包函數(shù),在閉包函數(shù)中導(dǎo)致的狀態(tài)變化系統(tǒng)會自動插入過渡動畫座享。

AnimateParam 對象說明

名稱 類型 描述
duration number 動畫持續(xù)時間婉商,單位為毫秒。 默認值:1000
tempo number 動畫的播放速度渣叛,值越大動畫播放越快丈秩,值越小播放越慢,為 0 時無動畫效果淳衙。 默認值:1.0
curve Curve Curves
delay number 單位為 ms(毫秒)蘑秽,默認不延時播放。 默認值:0
iterations number 默認播放一次箫攀,設(shè)置為-1 時表示無限次播放肠牲。 默認值:1
playMode PlayMode 設(shè)置動畫播放模式,默認播放完成后重頭開始播放靴跛。 默認值:PlayMode.Normal
onFinish () => void 動效播放完成回調(diào)缀雳。

示例

// xxx.ets
@Entry
@Component
struct AnimateToExample {
  @State widthSize: number = 250
  @State heightSize: number = 100
  @State rotateAngle: number = 0
  private flag: boolean = true

  build() {
    Column() {
      Button('change width and height')
        .width(this.widthSize)
        .height(this.heightSize)
        .margin(30)
        .onClick(() => {
          if (this.flag) {
            animateTo({
              duration: 2000,
              curve: Curve.EaseOut,
              iterations: 3,
              playMode: PlayMode.Normal,
              onFinish: () => {
                console.info('play end')
              }
            }, () => {
              this.widthSize = 100
              this.heightSize = 50
            })
          } else {
            animateTo({}, () => {
              this.widthSize = 250
              this.heightSize = 100
            })
          }
          this.flag = !this.flag
        })
      Button('change rotate angle')
        .margin(50)
        .rotate({ angle: this.rotateAngle })
        .onClick(() => {
          animateTo({
            duration: 1200,
            curve: Curve.Friction,
            delay: 500,
            iterations: -1, // 設(shè)置-1表示動畫無限循環(huán)
            playMode: PlayMode.AlternateReverse,
            onFinish: () => {
              console.info('play end')
            }
          }, () => {
            this.rotateAngle = 90
          })
        })
    }.width('100%').margin({ top: 5 })
  }
}

注:效果和屬性動畫等價

轉(zhuǎn)場動畫

頁面間轉(zhuǎn)場

在全局 pageTransition 方法內(nèi)配置頁面入場和頁面退場時的自定義轉(zhuǎn)場動效。

名稱 參數(shù) 參數(shù)描述
PageTransitionEnter { type: RouteType, duration: number, curve:Curve string, delay: number }
PageTransitionExit { type: RouteType, duration: number, curve: Curve string, delay: number }

RouteType 枚舉說明

名稱 描述
Pop 重定向指定頁面梢睛。PageA 跳轉(zhuǎn)到 PageB 時肥印,PageA 為 Exit+Pop,PageB 為 Enter+Pop绝葡。
Push 跳轉(zhuǎn)到下一頁面深碱。PageB 返回至 PageA 時,PageA 為 Enter+Push挤牛,PageB 為 Exit+Push莹痢。
None 頁面未重定向。

屬性

參數(shù)名稱 參數(shù)類型 必填 參數(shù)描述
slide SlideEffect 設(shè)置頁面轉(zhuǎn)場時的滑入滑出效果。 默認值:SlideEffect.Right
translate { x? : number string, y? : number string, z? : number
scale { x? : number, y? : number, z? : number, centerX? : number string, centerY? : number string }
opacity number 設(shè)置入場的起點透明度值或者退場的終點透明度值竞膳。 默認值:1

SlideEffect 枚舉說明

名稱 描述
Left 設(shè)置到入場時表示從左邊滑入航瞭,出場時表示滑出到左邊。
Right 設(shè)置到入場時表示從右邊滑入坦辟,出場時表示滑出到右邊刊侯。
Top 設(shè)置到入場時表示從上邊滑入,出場時表示滑出到上邊锉走。
Bottom 設(shè)置到入場時表示從下邊滑入滨彻,出場時表示滑出到下邊。

事件

事件 功能描述
onEnter(event: (type?: RouteType, progress?: number) => void) 回調(diào)入?yún)楫?dāng)前入場動畫的歸一化進度[0 - 1]挪蹭。 - type:跳轉(zhuǎn)方法亭饵。 - progress:當(dāng)前進度。
onExit(event: (type?: RouteType, progress?: number) => void) 回調(diào)入?yún)楫?dāng)前退場動畫的歸一化進度[0 - 1]梁厉。 - type:跳轉(zhuǎn)方法辜羊。 - progress:當(dāng)前進度。

組件內(nèi)轉(zhuǎn)場

組件內(nèi)轉(zhuǎn)場主要通過 transition 屬性配置轉(zhuǎn)場參數(shù)词顾,在組件插入和刪除時顯示過渡動效八秃,主要用于容器組件中的子組件插入和刪除時,提升用戶體驗(需要配合 animateTo) 才能生效肉盹,動效時長昔驱、曲線、延時跟隨 animateTo 中的配置)上忍。

屬性

名稱 參數(shù)類型 參數(shù)描述
transition TransitionOptions 所有參數(shù)均為可選參數(shù)骤肛,詳細描述見 TransitionOptions 參數(shù)說明。

TransitionOptions 參數(shù)說明

參數(shù)名稱 參數(shù)類型 必填 參數(shù)描述
type TransitionType 默認包括組件新增和刪除睡雇。 默認值:TransitionType.All****說明:不指定 Type 時說明插入刪除使用同一種效果萌衬。
opacity number 設(shè)置組件轉(zhuǎn)場時的透明度效果,為插入時起點和刪除時終點的值它抱。 默認值:1
translate { x? : number, y? : number, z? : number } 設(shè)置組件轉(zhuǎn)場時的平移效果秕豫,為插入時起點和刪除時終點的值。 -x:橫向的平移距離观蓄。 -y:縱向的平移距離混移。 -z:豎向的平移距離。
scale { x? : number, y? : number, z? : number, centerX? : number, centerY? : number } 設(shè)置組件轉(zhuǎn)場時的縮放效果侮穿,為插入時起點和刪除時終點的值歌径。 -x:橫向放大倍數(shù)(或縮小比例)。 -y:縱向放大倍數(shù)(或縮小比例)亲茅。 -z:豎向放大倍數(shù)(或縮小比例)回铛。 - centerX狗准、centerY 縮放中心點。 - 中心點為 0 時茵肃,默認的是組件的左上角腔长。
rotate { x?: number, y?: number, z?: number, angle?: Angle, centerX?: Length, centerY?: Length } 設(shè)置組件轉(zhuǎn)場時的旋轉(zhuǎn)效果,為插入時起點和刪除時終點的值验残。 -x:橫向的旋轉(zhuǎn)向量捞附。 -y:縱向的旋轉(zhuǎn)向量。 -z:豎向的旋轉(zhuǎn)向量您没。 - centerX,centerY 指旋轉(zhuǎn)中心點鸟召。 - 中心點為(0,0)時氨鹏,默認的是組件的左上角欧募。

示例

// xxx.ets
@Entry
@Component
struct TransitionExample {
  @State flag: boolean = true
  @State show: string = 'show'

  build() {
    Column() {
      Button(this.show).width(80).height(30).margin(30)
        .onClick(() => {
          // 點擊Button控制Image的顯示和消失
          animateTo({ duration: 1000 }, () => {
            if (this.flag) {
              this.show = 'hide'
            } else {
              this.show = 'show'
            }
            this.flag = !this.flag
          })
        })
      if (this.flag) {
        // Image的顯示和消失配置為不同的過渡效果
        Image($r('app.media.testImg')).width(300).height(300)
          .transition({ type: TransitionType.Insert, scale: { x: 0, y: 1.0 } })
          .transition({ type: TransitionType.Delete, rotate: { angle: 180 } })
      }
    }.width('100%')
  }
}

共享元素轉(zhuǎn)場

設(shè)置頁面間轉(zhuǎn)場時共享元素的轉(zhuǎn)場動效。

屬性

名稱 參數(shù) 參數(shù)描述
sharedTransition id: string, { duration?: number, curve?: Curve string, delay?: number, motionPath?: { path: string, form?: number, to?: number, rotatable?: boolean }, zIndex?: number, type?:SharedTransitionEffectType}

示例

示例代碼為點擊圖片跳轉(zhuǎn)頁面時喻犁,顯示共享元素圖片的自定義轉(zhuǎn)場動效槽片。

// xxx.ets
@Entry
@Component
struct SharedTransitionExample {
  @State active: boolean = false

  build() {
    Column() {
      Navigator({ target: 'pages/PageB', type: NavigationType.Push }) {
        Image($r('app.media.ic_health_heart')).width(50).height(50)
          .sharedTransition('sharedImage', { duration: 800, curve: Curve.Linear, delay: 100 })
      }.padding({ left: 20, top: 20 })
      .onClick(() => {
        this.active = true
      })
    }
  }
}

// PageB.ets
@Entry
@Component
struct pageBExample {
  build() {
    Stack() {
      Image($r('app.media.ic_health_heart')).width(150).height(150).sharedTransition('sharedImage')
    }.width('100%').height('100%')
  }
}

路徑動畫

設(shè)置組件進行位移動畫時的運動路徑。

屬性

名稱 參數(shù)類型 默認值 描述
motionPath { path: string, from?: number, to?: number, rotatable?: boolean }****說明:path 中支持使用 start 和 end 進行起點和終點的替代肢础,如: 'Mstart.x start.y L50 50 Lend.x end.y Z' { '', 0.0, 1.0, false } 設(shè)置組件的運動路徑,入?yún)⒄f明如下: - path:位移動畫的運動路徑碌廓,使用 svg 路徑字符串传轰。 - from:運動路徑的起點,默認為 0.0谷婆。 - to:運動路徑的終點慨蛙,默認為 1.0。 - rotatable:是否跟隨路徑進行旋轉(zhuǎn)纪挎。

示例

// xxx.ets
@Entry
@Component
struct MotionPathExample {
  @State toggle: boolean = true

  build() {
    Column() {
      Button('click me')
        // 執(zhí)行動畫:從起點移動到(300,200)期贫,再到(300,500),再到終點
        .motionPath({ path: 'Mstart.x start.y L300 200 L300 500 Lend.x end.y', from: 0.0, to: 1.0, rotatable: true })
        .onClick(() => {
          animateTo({ duration: 4000, curve: Curve.Linear }, () => {
            this.toggle = !this.toggle // 通過this.toggle變化組件的位置
          })
        })
    }.width('100%').height('100%').alignItems(this.toggle ? HorizontalAlign.Start : HorizontalAlign.Center)
  }
}

窗口動畫

窗口動畫管理器异袄,可以監(jiān)聽?wèi)?yīng)用啟動退出時應(yīng)用的動畫窗口通砍,提供啟動退出過程中控件動畫和應(yīng)用窗口聯(lián)動動畫能力。

導(dǎo)入模塊

import windowAnimationManager from '@ohos.animation.windowAnimationManager'

windowAnimationManager.setController

setController(controller: WindowAnimationController): void

設(shè)置窗口動畫控制器烤蜕。

在使用 windowAnimationManager 的其他接口前封孙,需要預(yù)先調(diào)用本接口設(shè)置窗口動畫控制器。

參數(shù):

參數(shù)名 類型 必填 說明
controller WindowAnimationController 窗口動畫的控制器讽营。

windowAnimationManager.minimizeWindowWithAnimation

minimizeWindowWithAnimation(windowTarget: WindowAnimationTarget): Promise

最小化動畫目標窗口虎忌,并返回動畫完成的回調(diào)。使用 Promise 異步回調(diào)橱鹏。

參數(shù):

參數(shù)名 類型 必填 說明
windowTarget WindowAnimationTarget 動畫目標窗口膜蠢。

返回值:

類型 說明
PromiseWindowAnimationFinishedCallback Promise 對象堪藐,返回動畫完成的回調(diào)。

WindowAnimationController

窗口動畫控制器挑围。在創(chuàng)建一個 WindowAnimationController 對象時礁竞,需要實現(xiàn)其中的所有回調(diào)函數(shù)。

onStartAppFromLauncher

onStartAppFromLauncher(startingWindowTarget: WindowAnimationTarget,finishCallback: WindowAnimationFinishedCallback): void

從桌面啟動應(yīng)用時的回調(diào)贪惹。

參數(shù)名 類型 必填 說明
startingWindowTarget WindowAnimationTarget 動畫目標窗口苏章。
finishCallback WindowAnimationFinishedCallback 動畫完成后的回調(diào)。

onStartAppFromRecent

onStartAppFromRecent(startingWindowTarget: WindowAnimationTarget,finishCallback:WindowAnimationFinishedCallback): void

從最近任務(wù)列表啟動應(yīng)用時的回調(diào)奏瞬。

參數(shù)名 類型 必填 說明
startingWindowTarget WindowAnimationTarget 動畫目標窗口枫绅。
finishCallback WindowAnimationFinishedCallback 動畫完成后的回調(diào)。

onStartAppFromOther

onStartAppFromOther(startingWindowTarget: WindowAnimationTarget,finishCallback: WindowAnimationFinishedCallback): void

從除了桌面和最近任務(wù)列表以外其他地方啟動應(yīng)用時的回調(diào)硼端。

參數(shù)名 類型 必填 說明
startingWindowTarget WindowAnimationTarget 動畫目標窗口并淋。
finishCallback WindowAnimationFinishedCallback 動畫完成后的回調(diào)。

onAppTransition

onAppTransition(fromWindowTarget: WindowAnimationTarget, toWindowTarget: WindowAnimationTarget,finishCallback: WindowAnimationFinishedCallback): void

應(yīng)用轉(zhuǎn)場時的回調(diào)珍昨。

參數(shù)名 類型 必填 說明
fromWindowTarget WindowAnimationTarget 轉(zhuǎn)場前的動畫窗口县耽。
toWindowTarget WindowAnimationTarget 轉(zhuǎn)場后的動畫窗口。
finishCallback WindowAnimationFinishedCallback 動畫完成后的回調(diào)镣典。

onMinimizeWindow

onMinimizeWindow(minimizingWindowTarget: WindowAnimationTarget,finishCallback: WindowAnimationFinishedCallback): void

最小化窗口時的回調(diào)兔毙。

參數(shù)名 類型 必填 說明
minimizingWindowTarget WindowAnimationTarget 動畫目標窗口。
finishCallback WindowAnimationFinishedCallback 動畫完成后的回調(diào)兄春。

onCloseWindow

onCloseWindow(closingWindowTarget: WindowAnimationTarget,finishCallback: WindowAnimationFinishedCallback): void

關(guān)閉窗口時的回調(diào)澎剥。

參數(shù)名 類型 必填 說明
closingWindowTarget WindowAnimationTarget 動畫目標窗口。
finishCallback WindowAnimationFinishedCallback 動畫完成后的回調(diào)赶舆。

onScreenUnlock

onScreenUnlock(finishCallback: WindowAnimationFinishedCallback): void

屏幕解鎖時的回調(diào)哑姚。

參數(shù)名 類型 必填 說明
finishCallback WindowAnimationFinishedCallback 動畫完成后的回調(diào)。

onWindowAnimationTargetsUpdate

onWindowAnimationTargetsUpdate(fullScreenWindowTarget: WindowAnimationTarget, floatingWindowTargets: Array): void

動畫目標窗口更新時的回調(diào)

參數(shù)名 類型 必填 說明
fullScreenWindowTarget WindowAnimationTarget 全屏狀態(tài)的動畫目標窗口芜茵。
floatingWindowTargets Array WindowAnimationTarget 懸浮狀態(tài)的動畫目標窗口

WindowAnimationFinishedCallback

動畫完成后的回調(diào)叙量。
onAnimationFinish
onAnimationFinish():void

結(jié)束本次動畫。

應(yīng)用層使用

OpenHarmony 中應(yīng)用層的窗口動畫定義在 Launcher 系統(tǒng)應(yīng)用中九串,由 Launcher 應(yīng)用統(tǒng)一規(guī)范應(yīng)用的窗口動畫

WindowController 的實現(xiàn)見 WindowAnimationControllerImpl.ts绞佩,定義了 onStartAppFromLauncher、onStartAppFromRecent蒸辆、onStartAppFromOther征炼、onAppTransition、onMinimizeWindow躬贡、onCloseWindow谆奥、onScreenUnlock 等實現(xiàn)方式

import Prompt from '@ohos.prompt';
import windowAnimationManager from '@ohos.animation.windowAnimationManager';
import { CheckEmptyUtils } from '@ohos/common';
import { Log } from '@ohos/common';
import RemoteConstants from '../../constants/RemoteConstants';

const TAG = 'WindowAnimationControllerImpl';

class WindowAnimationControllerImpl implements windowAnimationManager.WindowAnimationController {
  onStartAppFromLauncher(startingWindowTarget: windowAnimationManager.WindowAnimationTarget,
                         finishCallback: windowAnimationManager.WindowAnimationFinishedCallback): void
  {
    Log.showInfo(TAG, `remote window animaion onStartAppFromLauncher`);
    this.setRemoteAnimation(startingWindowTarget, null, finishCallback, RemoteConstants.TYPE_START_APP_FROM_LAUNCHER);
    this.printfTarget(startingWindowTarget);
    finishCallback.onAnimationFinish();
  }

  onStartAppFromRecent(startingWindowTarget: windowAnimationManager.WindowAnimationTarget,
                       finishCallback: windowAnimationManager.WindowAnimationFinishedCallback): void {
    Log.showInfo(TAG, `remote window animaion onStartAppFromRecent`);
    this.setRemoteAnimation(startingWindowTarget, null, finishCallback, RemoteConstants.TYPE_START_APP_FROM_RECENT);
    this.printfTarget(startingWindowTarget);
    finishCallback.onAnimationFinish();
  }

  onStartAppFromOther(startingWindowTarget: windowAnimationManager.WindowAnimationTarget,
                      finishCallback: windowAnimationManager.WindowAnimationFinishedCallback): void {
    Log.showInfo(TAG, `remote window animaion onStartAppFromOther`);
    this.setRemoteAnimation(startingWindowTarget, null, finishCallback, RemoteConstants.TYPE_START_APP_FROM_OTHER);
    this.printfTarget(startingWindowTarget);
    finishCallback.onAnimationFinish();
  }

  onAppTransition(fromWindowTarget: windowAnimationManager.WindowAnimationTarget,
                  toWindowTarget: windowAnimationManager.WindowAnimationTarget,
                  finishCallback: windowAnimationManager.WindowAnimationFinishedCallback): void{
    Log.showInfo(TAG, `remote window animaion onAppTransition`);
    this.setRemoteAnimation(toWindowTarget, fromWindowTarget, finishCallback, RemoteConstants.TYPE_APP_TRANSITION);
    this.printfTarget(fromWindowTarget);
    this.printfTarget(toWindowTarget);
    finishCallback.onAnimationFinish();
  }

  onMinimizeWindow(minimizingWindowTarget: windowAnimationManager.WindowAnimationTarget,
                   finishCallback: windowAnimationManager.WindowAnimationFinishedCallback): void {
    Log.showInfo(TAG, `remote window animaion onMinimizeWindow`);
    this.setRemoteAnimation(null, minimizingWindowTarget, finishCallback, RemoteConstants.TYPE_MINIMIZE_WINDOW);
    this.printfTarget(minimizingWindowTarget);
    finishCallback.onAnimationFinish();
  }

  onCloseWindow(closingWindowTarget: windowAnimationManager.WindowAnimationTarget,
                finishCallback: windowAnimationManager.WindowAnimationFinishedCallback): void {
    Log.showInfo(TAG, `remote window animaion onCloseWindow`);
    this.setRemoteAnimation(null, closingWindowTarget, finishCallback, RemoteConstants.TYPE_CLOSE_WINDOW);
    this.printfTarget(closingWindowTarget);
    finishCallback.onAnimationFinish();
  }

  onScreenUnlock(finishCallback: windowAnimationManager.WindowAnimationFinishedCallback): void {
    Log.showInfo(TAG, `remote window animaion onScreenUnlock`);
    this.setRemoteAnimation(null, null, finishCallback, RemoteConstants.TYPE_SCREEN_UNLOCK);
    finishCallback.onAnimationFinish();
  }

  onWindowAnimationTargetsUpdate(fullScreenWindowTarget: windowAnimationManager.WindowAnimationTarget, floatingWindowTargets: Array<windowAnimationManager.WindowAnimationTarget>): void {}

  printfTarget(target: windowAnimationManager.WindowAnimationTarget): void {
    if (CheckEmptyUtils.isEmpty(target) || CheckEmptyUtils.isEmpty(target.windowBounds)) {
      Log.showInfo(TAG, `remote window animaion with invalid target`);
      return;
    }
    Log.showInfo(TAG, `remote window animaion bundleName: ${target.bundleName} abilityName: ${target.abilityName}`);
    Log.showInfo(TAG, `remote window animaion windowBounds left: ${target.windowBounds.left} top: ${target.windowBounds.top}
      width: ${target.windowBounds.width} height: ${target.windowBounds.height} radius: ${target.windowBounds.radius}`);
  }

  private setRemoteAnimation(startingWindowTarget: windowAnimationManager.WindowAnimationTarget,
                             closingWindowTarget: windowAnimationManager.WindowAnimationTarget,
                             finishCallback: windowAnimationManager.WindowAnimationFinishedCallback,
                             remoteAnimationType: number): void {
    if (!CheckEmptyUtils.isEmpty(startingWindowTarget)) {
      AppStorage.SetOrCreate('startingWindowTarget', startingWindowTarget);
    }

    if (!CheckEmptyUtils.isEmpty(closingWindowTarget)) {
      AppStorage.SetOrCreate('closingWindowTarget', closingWindowTarget);
    }

    if (!CheckEmptyUtils.isEmpty(finishCallback)) {
      AppStorage.SetOrCreate('remoteAnimationFinishCallback', finishCallback);
    }

    AppStorage.SetOrCreate('remoteAnimationType', remoteAnimationType);
  }
}

export default WindowAnimationControllerImpl

RemoteWindowWrapper.ets 中定義了具體的窗口動畫實現(xiàn)效果(通過 animateTo 實現(xiàn)具體的動畫效果)

calculateAppProperty(remoteVo: RemoteVo, finishCallback: windowAnimationManager.WindowAnimationFinishedCallback) {
  Log.showDebug(TAG, `calculateAppProperty ${remoteVo.remoteAnimationType}`);
  if (remoteVo.remoteAnimationType == RemoteConstants.TYPE_START_APP_FROM_LAUNCHER) {
    Trace.start(Trace.CORE_METHOD_START_APP_ANIMATION);
    const callback = Object.assign(finishCallback);
    const count = remoteVo.count;
    localEventManager.sendLocalEventSticky(EventConstants.EVENT_ANIMATION_START_APPLICATION, null);
    animateTo({
      duration: 180,
      delay: 100,
      curve: Curve.Friction,
      onFinish: () => {
      }
    }, () => {
      remoteVo.startAppIconWindowAlpha = 0.0;
      remoteVo.remoteWindowWindowAlpha = 1.0;
    })

    animateTo({
      duration: 500,
      // @ts-ignore
      curve: curves.springMotion(0.32, 0.99, 0),
      onFinish: () => {
        callback.onAnimationFinish();
        Trace.end(Trace.CORE_METHOD_START_APP_ANIMATION);
        const startCount: number = AppStorage.Get(remoteVo.remoteWindowKey);
        Log.showDebug(TAG, `calculateAppProperty ${remoteVo.remoteAnimationType}, count: ${count}, startCount: ${startCount}`);
        if (startCount === count || count == 0) {
          this.removeRemoteWindowFromList(remoteVo.remoteWindowKey);
          AppStorage.SetOrCreate(remoteVo.remoteWindowKey, 0);
        }
      }
    }, () => {
      remoteVo.remoteWindowScaleX = 1.0;
      remoteVo.remoteWindowScaleY = 1.0;
      remoteVo.remoteWindowTranslateX = 0.0;
      remoteVo.remoteWindowTranslateY = 0.0;
      remoteVo.startAppIconScaleX = remoteVo.mScreenWidth / remoteVo.iconInfo?.appIconSize;
      remoteVo.startAppIconTranslateX = remoteVo.mScreenWidth / 2 - remoteVo.iconInfo?.appIconPositionX - remoteVo.iconInfo?.appIconSize / 2;
      remoteVo.remoteWindowRadius = 0;
      if (remoteVo.startAppTypeFromPageDesktop === CommonConstants.OVERLAY_TYPE_CARD) {
        remoteVo.startAppIconScaleY = remoteVo.mScreenHeight / remoteVo.iconInfo?.appIconHeight;
        remoteVo.startAppIconTranslateY = remoteVo.mScreenHeight / 2 + px2vp(remoteVo.target.windowBounds.top) - remoteVo.iconInfo?.appIconPositionY - remoteVo.iconInfo?.appIconHeight / 2;
      } else {
        remoteVo.startAppIconScaleY = remoteVo.mScreenHeight / remoteVo.iconInfo?.appIconSize;
        remoteVo.startAppIconTranslateY = remoteVo.mScreenHeight / 2 + px2vp(remoteVo.target.windowBounds.top) - remoteVo.iconInfo?.appIconPositionY - remoteVo.iconInfo?.appIconSize / 2;
      }
    })
  } else if (remoteVo.remoteAnimationType  == RemoteConstants.TYPE_MINIMIZE_WINDOW) {
    Trace.start(Trace.CORE_METHOD_CLOSE_APP_ANIMATION);
    const res = remoteVo.calculateCloseAppProperty();
    const callback = Object.assign(finishCallback);
    const count = remoteVo.count;
    localEventManager.sendLocalEventSticky(EventConstants.EVENT_ANIMATION_CLOSE_APPLICATION, null);
    animateTo({
      duration: 700,
      // @ts-ignore
      curve: curves.springMotion(0.40, 0.99, 0),
      onFinish: () => {
        callback.onAnimationFinish();
        Trace.end(Trace.CORE_METHOD_CLOSE_APP_ANIMATION);
        const startCount: number = AppStorage.Get(remoteVo.remoteWindowKey);
        Log.showDebug(TAG, `calculateAppProperty ${remoteVo.remoteAnimationType}, count: ${count}, startCount: ${startCount}`);
        if (startCount === count || count == 0) {
          this.removeRemoteWindowFromList(remoteVo.remoteWindowKey);
          AppStorage.SetOrCreate(remoteVo.remoteWindowKey, 0);
        }
      }
    }, () => {
      remoteVo.remoteWindowScaleX = 1 / res.closeAppCalculateScaleX;
      remoteVo.remoteWindowScaleY = 1 / res.closeAppCalculateScaleY;
      remoteVo.remoteWindowTranslateX = res.closeAppCalculateTranslateX;
      remoteVo.remoteWindowTranslateY = res.closeAppCalculateTranslateY;

      remoteVo.startAppIconScaleX = 1.0;
      remoteVo.startAppIconScaleY = 1.0;
      remoteVo.startAppIconTranslateX = 0.0;
      remoteVo.startAppIconTranslateY = 0.0;
      remoteVo.remoteWindowRadius = 96;
    })

    animateTo({
      duration: 140,
      delay: 350,
      curve: Curve.Friction,
      onFinish: () => {
      }
    }, () => {
      remoteVo.startAppIconWindowAlpha = 1.0;
      remoteVo.remoteWindowWindowAlpha = 0;
    })
  } else if (remoteVo.remoteAnimationType  == RemoteConstants.TYPE_CLOSE_WINDOW) {
  } else if (remoteVo.remoteAnimationType  == RemoteConstants.TYPE_APP_TRANSITION) {
    const callback = Object.assign(finishCallback);
    animateTo({
      duration: 500,
      curve: Curve.Friction,
      onFinish: () => {
        callback.onAnimationFinish();
        this.removeRemoteWindowFromList(remoteVo.remoteWindowKey);
      }
    }, () => {
      remoteVo.remoteWindowRadius = 0;
      remoteVo.remoteWindowTranslateX = 0;
      remoteVo.fromRemoteWindowTranslateX = px2vp(remoteVo.fromWindowTarget?.windowBounds.left - remoteVo.fromWindowTarget?.windowBounds.width);
    })

    animateTo({
      duration: 150,
      curve: Curve.Friction,
      onFinish: () => {
        callback.onAnimationFinish();
        this.removeRemoteWindowFromList(remoteVo.remoteWindowKey);
      }
    }, () => {
      remoteVo.remoteWindowScaleX = 0.9
      remoteVo.remoteWindowScaleY = 0.9
      remoteVo.fromRemoteWindowScaleX = 0.9
      remoteVo.fromRemoteWindowScaleY = 0.9
    })

    animateTo({
      duration: 350,
      delay: 150,
      curve: Curve.Friction,
      onFinish: () => {
        callback.onAnimationFinish();
        this.removeRemoteWindowFromList(remoteVo.remoteWindowKey);
      }
    }, () => {
      remoteVo.remoteWindowScaleX = 1.0
      remoteVo.remoteWindowScaleY = 1.0
      remoteVo.fromRemoteWindowScaleX = 1.0
      remoteVo.fromRemoteWindowScaleY = 1.0
    })
  }
}

注:若想修改系統(tǒng)的窗口動畫效果,可通過修改對應(yīng)的動畫實現(xiàn)

底層實現(xiàn)

窗口動畫的底層實現(xiàn)具體見:foundation\window\window_manager\wmserver\src\remote_animation.cpp

WMError RemoteAnimation::SetWindowAnimationController(const sptr<RSIWindowAnimationController>& controller)
{
    WLOGFI("RSWindowAnimation: set window animation controller!");
    if (!isRemoteAnimationEnable_) {
        WLOGE("RSWindowAnimation: failed to set window animation controller, remote animation is not enabled");
        return WMError::WM_ERROR_NO_REMOTE_ANIMATION;
    }
    if (controller == nullptr) {
        WLOGFE("RSWindowAnimation: failed to set window animation controller, controller is null!");
        return WMError::WM_ERROR_NULLPTR;
    }

    if (windowAnimationController_ != nullptr) {
        WLOGFI("RSWindowAnimation: maybe user switch!");
    }

    windowAnimationController_ = controller;
    return WMError::WM_OK;
}

RSIWindowAnimationController 具體定義見:foundation\graphic\graphic_2d\interfaces\kits\napi\graphic\animation\window_animation_manager\rs_window_animation_controller.cpp

void RSWindowAnimationController::HandleOnStartApp(StartingAppType type,
    const sptr<RSWindowAnimationTarget>& startingWindowTarget,
    const sptr<RSIWindowAnimationFinishedCallback>& finishedCallback)
{
    WALOGD("Handle on start app.");
    NativeValue* argv[] = {
        RSWindowAnimationUtils::CreateJsWindowAnimationTarget(engine_, startingWindowTarget),
        RSWindowAnimationUtils::CreateJsWindowAnimationFinishedCallback(engine_, finishedCallback),
    };

    switch (type) {
        case StartingAppType::FROM_LAUNCHER:
            CallJsFunction("onStartAppFromLauncher", argv, ARGC_TWO);
            break;
        case StartingAppType::FROM_RECENT:
            CallJsFunction("onStartAppFromRecent", argv, ARGC_TWO);
            break;
        case StartingAppType::FROM_OTHER:
            CallJsFunction("onStartAppFromOther", argv, ARGC_TWO);
            break;
        default:
            WALOGE("Unknow starting app type.");
            break;
    }
}

void RSWindowAnimationController::HandleOnAppTransition(const sptr<RSWindowAnimationTarget>& fromWindowTarget,
    const sptr<RSWindowAnimationTarget>& toWindowTarget,
    const sptr<RSIWindowAnimationFinishedCallback>& finishedCallback)
{
    WALOGD("Handle on app transition.");
    NativeValue* argv[] = {
        RSWindowAnimationUtils::CreateJsWindowAnimationTarget(engine_, fromWindowTarget),
        RSWindowAnimationUtils::CreateJsWindowAnimationTarget(engine_, toWindowTarget),
        RSWindowAnimationUtils::CreateJsWindowAnimationFinishedCallback(engine_, finishedCallback),
    };
    CallJsFunction("onAppTransition", argv, ARGC_THREE);
}
...

通過 CallJsFunction 實現(xiàn)具體的 napi 調(diào)用拂玻,實現(xiàn)具體的動畫效果

寫在最后

如果你覺得這篇內(nèi)容對你還蠻有幫助酸些,我想邀請你幫我三個小忙

  • 點贊宰译,轉(zhuǎn)發(fā),有你們的 『點贊和評論』魄懂,才是我創(chuàng)造的動力沿侈。
  • 關(guān)注小編,同時可以期待后續(xù)文章ing??市栗,不定期分享原創(chuàng)知識缀拭。
  • 想要獲取更多完整鴻蒙最新學(xué)習(xí)知識點,請移步前往小編:https://gitee.com/MNxiaona/733GH/blob/master/jianshu
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末填帽,一起剝皮案震驚了整個濱河市蛛淋,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌篡腌,老刑警劉巖褐荷,帶你破解...
    沈念sama閱讀 206,126評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機避咆,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,254評論 2 382
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來富纸,“玉大人,你說我怎么就攤上這事。” “怎么了棠赛?”我有些...
    開封第一講書人閱讀 152,445評論 0 341
  • 文/不壞的土叔 我叫張陵,是天一觀的道長膛腐。 經(jīng)常有香客問我,道長鼎俘,這世上最難降的妖魔是什么哲身? 我笑而不...
    開封第一講書人閱讀 55,185評論 1 278
  • 正文 為了忘掉前任,我火速辦了婚禮贸伐,結(jié)果婚禮上勘天,老公的妹妹穿的比我還像新娘。我一直安慰自己捉邢,他們只是感情好脯丝,可當(dāng)我...
    茶點故事閱讀 64,178評論 5 371
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著伏伐,像睡著了一般宠进。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上藐翎,一...
    開封第一講書人閱讀 48,970評論 1 284
  • 那天材蹬,我揣著相機與錄音实幕,去河邊找鬼。 笑死堤器,一個胖子當(dāng)著我的面吹牛昆庇,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播闸溃,決...
    沈念sama閱讀 38,276評論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼整吆,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了辉川?” 一聲冷哼從身側(cè)響起表蝙,我...
    開封第一講書人閱讀 36,927評論 0 259
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎员串,沒想到半個月后勇哗,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,400評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡寸齐,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 35,883評論 2 323
  • 正文 我和宋清朗相戀三年欲诺,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片渺鹦。...
    茶點故事閱讀 37,997評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡扰法,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出毅厚,到底是詐尸還是另有隱情塞颁,我是刑警寧澤,帶...
    沈念sama閱讀 33,646評論 4 322
  • 正文 年R本政府宣布吸耿,位于F島的核電站祠锣,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏咽安。R本人自食惡果不足惜伴网,卻給世界環(huán)境...
    茶點故事閱讀 39,213評論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望妆棒。 院中可真熱鬧澡腾,春花似錦、人聲如沸糕珊。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,204評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽红选。三九已至澜公,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間纠脾,已是汗流浹背玛瘸。 一陣腳步聲響...
    開封第一講書人閱讀 31,423評論 1 260
  • 我被黑心中介騙來泰國打工蜕青, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人糊渊。 一個月前我還...
    沈念sama閱讀 45,423評論 2 352
  • 正文 我出身青樓右核,卻偏偏與公主長得像,于是被迫代替她去往敵國和親渺绒。 傳聞我的和親對象是個殘疾皇子贺喝,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 42,722評論 2 345

推薦閱讀更多精彩內(nèi)容