回调退出动态播放（Web）

最終更新： 2020年1月30日

概述

在Cubism SDK for Web中，您现在可以在退出动态播放时，通过回调获取Event。

在范例中，通过回调函数输出退出播放的记录文本。

回调实装

此次，由于在退出动态播放时通过回调进行处理，因此进行实装，使其能够通过管理动态的抽象类
Framework/src/motion/acubismmotion进行回调处理。

export namespace Live2DCubismFramework
{
    // 退出动态播放的回调函数的定义
    export type FinishedMotionCallback = (self: ACubismMotion) => void
  
    export abstract class ACubismMotion
    {
        ・
        ・
        ・
        // 注册退出动态播放的回调
        public setFinishedMotionHandler =
            (onFinishedMotionHandler: FinishedMotionCallback) =>
                this._onFinishedMotion = onFinishedMotionHandler;

        // 获取退出动态播放的回调
        public getFinishedMotionHandler = () => this._onFinishedMotion;
        ・
        ・
        ・
        // 加入了退出动态播放时调用的回调函数的变量
        public _onFinishedMotion?: FinishedMotionCallback;
    }
}

回调函数的使用

实装希望通过回调函数实际处理的内容。

在范例中进行实装，以使用LAppPal.printMessage()输出通知退出动态播放的记录文本。
如果要在退出动态播放时变更处理，请变更以下函数的实装。

_finishedMotion = (self: ACubismMotion) => {
    LAppPal.printMessage("Motion Finished:");
    console.log(self);
}

另外，在注册回调函数时，在使用导入动态数据的Framework层的CubismUserModel.loadMotion()时，在生成动态的同时传递回调函数。
如果已经有了一个动态，则使用“实装回调”中介绍的setFinishedMotionHandler()。

public startMotion(
    group: string,
    no: number,
    priority: number,
    onFinishedMotionHandler?: FinishedMotionCallback
): CubismMotionQueueEntryHandle {
    ・
    ・
    ・
    if(motion == null)
    {
        let path: string = fileName;
        path = this._modelHomeDir + path;

        fetch(path).then(
            (response) =>
            {
                return response.arrayBuffer();
            }
        ).then(
            (arrayBuffer) =>
            {
                let buffer: ArrayBuffer = arrayBuffer;
                let size = buffer.byteLength;

                // 通过在导入动态数据的同时传递回调函数来注册
                motion = <CubismMotion>this.loadMotion(buffer, size, null, onFinishedMotionHandler);
                ・
                ・
                ・
            }
        );
    } else {
        motion.setFinishedMotionHandler(onFinishedMotionHandler);
    }
}

在范例中，回调函数是从执行获取点击Event的OnTap()时调用的startRandomMotion()传入。

此外，由于实际播放动态的是CubismMotion.doUpdateParameters()，因此进行实装，以便可以将回调函数传递给CubismMotion。

public static create(
    buffer: ArrayBuffer,
    size: number,
    onFinishedMotionHandler?: FinishedMotionCallback
): CubismMotion {
    const ret = new CubismMotion();

    ret.parse(buffer, size);
    ret._sourceFrameRate = ret._motionData.fps;
    ret._loopDurationSeconds = ret._motionData.duration;
    // 回调函数的注册
    ret._onFinishedMotion = onFinishedMotionHandler;

    return ret;
}

关于实装的发展

范例中只实装了退出动态播放，但通过发展这些实装，可以在退出动态播放后通过回调函数进行异步处理等，
通过从要应用回调的实际处理中反转函数，您可以在退出动态播放以外的地方实装回调。