TweenService

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Oluşturulamaz
Hizmet

TweenService bileşenlerin özelliklerini yer değiştirmeye veya geçişe dönüştüren Tweens oluşturmak için kullanılır.Tweens herhangi bir uyumlu özellik türüne sahip nesneye kullanılabilir, örneğin:

TweenService:Create() , ana yapıcı işlevi, tween hakkında TweenInfo özellikler alır ve daha sonra tween oynatmak için kullanılabilecek Tween nesneyi üretir.

Not that Tweens aynı anda birden fazla özellik yerine geçebilir, ancak aynı özelliği yerine geçirmemelidirler.Eğer iki genç aynı özelliği değiştirmeye çalışırsa, başlangıç genç iptal edilir ve en yeni genç tarafından üzerine yazılır.

Kod Örnekleri

In this example a Tween is created to animate the position and color of a Part. Because the position and color are part of the same tween, they will change at the exact same rate and will reach their goal at the same time.

Tween Creation

local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Color = Color3.new(1, 0, 0)
part.Anchored = true
part.Parent = game.Workspace
local goal = {}
goal.Position = Vector3.new(10, 10, 0)
goal.Color = Color3.new(0, 1, 0)
local tweenInfo = TweenInfo.new(5)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()

This code sample includes an example of how a looped tween can be created. A part is instanced in the Workspace and a Tween is created using TweenService:Create() that is set to animate its position along the Y axis.

The looped effect is achieved by modifying the TweenInfo used in TweenService:Create(). Specifically, when RepeatCount is set to less than 0, the tween will play indefinitely. Also, setting Reverses to true will cause the tween to play in reverse once it has reached its destination. In combination this creates a looped effect.

The correct way to make a tween play indefinitely is to set RepeatCount to -1. You should avoid using large numbers or math.huge() as a substitute as this is unstable and may stop working at any point.

Looping a Tween

local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Anchored = true
part.Parent = workspace
local tweenInfo = TweenInfo.new(
2, -- Time
Enum.EasingStyle.Linear, -- EasingStyle
Enum.EasingDirection.Out, -- EasingDirection
-1, -- RepeatCount (when less than zero the tween will loop indefinitely)
true, -- Reverses (tween will reverse once reaching its goal)
0 -- DelayTime
)
local tween = TweenService:Create(part, tweenInfo, { Position = Vector3.new(0, 30, 0) })
tween:Play()
task.wait(10)
tween:Cancel() -- cancel the animation after 10 seconds

This sample demonstrates how the playback of a tween can be paused and resumed.

A part is instanced in the Workspace and a tween is setup that will move it 50 studs along the X axis. However during playback the tween is briefly paused, then resumed. To further illustrate this the BrickColor of the part changes from red to green while it is paused.

Pausing a Tween

local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Anchored = true
part.BrickColor = BrickColor.new("Bright green")
part.Parent = workspace
local goal = {}
goal.Position = Vector3.new(50, 10, 0)
local tweenInfo = TweenInfo.new(10, Enum.EasingStyle.Linear)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()
task.wait(3)
part.BrickColor = BrickColor.new("Bright red")
tween:Pause()
task.wait(2)
part.BrickColor = BrickColor.new("Bright green")
tween:Play()

Özet

Yöntemler

Özellikler

Yöntemler

Create

Bu yapıcı, üç argümanlardan yeni bir Tween oluşturur: geçiş yapacak nesne, TweenInfo özellikleri ve geçiş yapacak özellikler ve değerler içeren bir tablo.

The propertyTable örneğin Position , Transparency veya Color özellik anahtarlarının dize adları olduğu bir sözlük olması gereken örneğin örneğin örneğin örneğin örneğin örneğin örneğin örneğin özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özellik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik özik ö

Bu işlev kullanılarak oluşturulan Tween bu işlev, verilen instance parametre olarak verilen nesneye benzersizdir.Aynı tween'i başka bir nesneye uygulamak için, bu işlevi yeni nesne ile tekrar çağırın.

Parametreler

instance: Instance

Özellikleri geçiştirilecek olan Instance kişi.

Varsayılan değer: ""
tweenInfo: TweenInfo

Kullanılacak TweenInfo .

Varsayılan değer: ""
propertyTable: Dictionary

Geçiştirilmesi gereken özelliklerin ve hedeflerinin değerleri içeren bir sözlük.

Varsayılan değer: ""

Dönüşler

Kod Örnekleri

In this example a Tween is created to animate the position and color of a Part. Because the position and color are part of the same tween, they will change at the exact same rate and will reach their goal at the same time.

Tween Creation

local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Color = Color3.new(1, 0, 0)
part.Anchored = true
part.Parent = game.Workspace
local goal = {}
goal.Position = Vector3.new(10, 10, 0)
goal.Color = Color3.new(0, 1, 0)
local tweenInfo = TweenInfo.new(5)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()

This code sample includes an example of how a looped tween can be created. A part is instanced in the Workspace and a Tween is created using TweenService:Create() that is set to animate its position along the Y axis.

The looped effect is achieved by modifying the TweenInfo used in TweenService:Create(). Specifically, when RepeatCount is set to less than 0, the tween will play indefinitely. Also, setting Reverses to true will cause the tween to play in reverse once it has reached its destination. In combination this creates a looped effect.

The correct way to make a tween play indefinitely is to set RepeatCount to -1. You should avoid using large numbers or math.huge() as a substitute as this is unstable and may stop working at any point.

Looping a Tween

local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Anchored = true
part.Parent = workspace
local tweenInfo = TweenInfo.new(
2, -- Time
Enum.EasingStyle.Linear, -- EasingStyle
Enum.EasingDirection.Out, -- EasingDirection
-1, -- RepeatCount (when less than zero the tween will loop indefinitely)
true, -- Reverses (tween will reverse once reaching its goal)
0 -- DelayTime
)
local tween = TweenService:Create(part, tweenInfo, { Position = Vector3.new(0, 30, 0) })
tween:Play()
task.wait(10)
tween:Cancel() -- cancel the animation after 10 seconds

GetValue

Verilen alfa değeri kullanarak yer değiştirme için yeni bir alfa değeri döndürür, Enum.EasingStyle ve Enum.EasingDirection.Verilen alpha değeri 0 ve 1 arasında sıkıştırılacaktır.

Parametreler

alpha: number

0 ve 1 arasında bir interpolasyon değeri.

Varsayılan değer: ""
easingStyle: Enum.EasingStyle

Kullanılacak kolaylaştırma stili.

Varsayılan değer: ""
easingDirection: Enum.EasingDirection

Kullanılacak kolaylaştırma yönü.

Varsayılan değer: ""

Dönüşler

Verdiğiniz rahatlama stili ve yönünden yeni bir alfa değeri oluşturuldu.

SmoothDamp

Paralel yaz

Bir değeri hedeflere doğru yumuşatmaya izin veren bir dizi döndürür ve kritik bir sarsıntılı baharı simüle eder.Destekler Vector2 , Vector3 , CFrame ve sayı.

Parametreler

current: Variant

Mevcut konum.

Varsayılan değer: ""
target: Variant

Hedef pozisyon.

Varsayılan değer: ""
velocity: Variant

Mevcut konumun hedef konuma yaklaşması gereken başlangıç ​​hızı.

Varsayılan değer: ""
smoothTime: number

Toplam düzleştirme işleminin dünyagereken süre.

Varsayılan değer: ""
maxSpeed: number

Mevcut konumun hedef konuma yaklaşması gereken maksimum hız.

Varsayılan değer: ""
dt: number

Dalgalandırma işlemi uygulanacak oran.

Varsayılan değer: ""

Dönüşler

Smoothing işleminden hesaplanan yeni pozisyon ve hız.

Etkinlikler