object:setSpeedScale()

类型 函数
返回值 无
修订版 发行版 2024.3703
关键字 动画、时间线、插值、setSpeedScale
另请参阅 object:getSpeedScale()
animation.setSpeedScale()
时间线
animation.*

概述

使用 animation.newTimeline() 创建的 Timeline 的播放速度缩放。

注意

更改速度缩放不会影响为开始时间线播放而设置的任何延迟。换句话说，只有时间线的实际播放部分会通过此方法进行修改。

语法

object:setSpeedScale( scale )
scale (必需)

数字。相对速度缩放。它必须大于 0 的正数。默认情况下，速度缩放为 1（正常速度）。大于 1 的值会提高速度，而低于 1 的值会降低速度。

示例

local object1 = display.newRect( 50, 50, 100, 100 )

-- Create a timeline object
local timelineParams = {
    tweens = {
        { startTime=0, tween={ object1, { x=400 }, { time=4000, iterations=5 } } },
        { startTime=1000, tween={ object1, { y=400 }, { time=4000, easing=easing.outQuad } } }
    }
}
local newTimeline = animation.newTimeline( timelineParams )

-- Set the timeline speed scale
newTimeline:setSpeedScale( 2.5 )

-- Set the timeline playing
newTimeline:resume()