KeyframeSequenceProvider
Provides functions to load and preview KeyframeSequence.
Memory category | Animation |
---|
Member index 7
Description
The KeyframeSequenceProvider service provides functions to load and preview KeyframeSequences. It includes a number of functions that are useful when working with Animations.
A KeyframeSequence stores a series of Poses that encode the hierarchy and motion of an animation. The animation data Roblox uses in the playback of an animation, referenced by the Animation.AnimationId property, can be constructed from a KeyframeSequence. KeyframeSequences are usually created by the Roblox Animation Editor but can be created through other plugins or even manually.
History 33
- 645 Change ReturnType of RegisterKeyframeSequence from Content to ContentId
- 645 Change ReturnType of RegisterActiveKeyframeSequence from Content to ContentId
- 645 Change Parameters of GetKeyframeSequenceAsync from (assetId: Content) to (assetId: ContentId)
- 645 Change Parameters of GetKeyframeSequence from (assetId: Content) to (assetId: ContentId)
- 553 Change PreferredDescriptor of GetKeyframeSequenceById from to GetKeyframeSequenceAsync
- 553 Change PreferredDescriptor of GetKeyframeSequence from to GetKeyframeSequenceAsync
- 462 Change ThreadSafety of RegisterKeyframeSequence from to Unsafe
- 462 Change ThreadSafety of RegisterActiveKeyframeSequence from to Unsafe
- 462 Change ThreadSafety of GetMemStats from to Unsafe
- 462 Change ThreadSafety of GetKeyframeSequenceById from to Unsafe
- 462 Change ThreadSafety of GetKeyframeSequenceAsync from to Unsafe
- 462 Change ThreadSafety of GetKeyframeSequence from to Unsafe
- 462 Change ThreadSafety of GetAnimations from to Unsafe
- 378 Add GetMemStats
- 322 Change Parameters of GetKeyframeSequenceById from (assetId: int, useCache: bool) to (assetId: int64, useCache: bool)
- 322 Change Parameters of GetAnimations from (userId: int) to (userId: int64)
- 321 Change Tags of GetKeyframeSequenceById from [] to [Deprecated]
- 321 Change Security of GetKeyframeSequenceById from None to PluginSecurity
- 321 Change Tags of GetKeyframeSequence from [] to [Deprecated]
- 321 Change Security of GetKeyframeSequence from None to PluginSecurity
- 296 Add GetKeyframeSequenceAsync
- 285 Change Parameters of GetAnimations from (userId: int, page: int = 1) to (userId: int)
- 285 Change ReturnType of GetAnimations from Dictionary to Instance
- 284 Change Parameters of GetAnimations from (userId: int) to (userId: int, page: int = 1)
- 284 Change ReturnType of GetAnimations from Instance to Dictionary
- 285 Change Parameters of GetAnimations from (userId: int, page: int = 1) to (userId: int)
- 285 Change ReturnType of GetAnimations from Dictionary to Instance
- 131 Add GetKeyframeSequenceById
- 131 Add GetAnimations
- 47 Add RegisterKeyframeSequence
- 47 Add RegisterActiveKeyframeSequence
- 47 Add GetKeyframeSequence
- 47 Add KeyframeSequenceProvider
Members 7
GetAnimations
Parameters (1) | ||
---|---|---|
userId | int64 | |
Returns (1) | ||
Instance |
This function returns an InventoryPages object which can be used to iterate over animations owned by a specific user.
This function has a number of potential uses, such as allowing users to browse and import animations into a custom animation plugin.
Thread safety | Unsafe |
---|
History 9
- 462 Change ThreadSafety of GetAnimations from to Unsafe
- 322 Change Parameters of GetAnimations from (userId: int) to (userId: int64)
- 285 Change Parameters of GetAnimations from (userId: int, page: int = 1) to (userId: int)
- 285 Change ReturnType of GetAnimations from Dictionary to Instance
- 284 Change Parameters of GetAnimations from (userId: int) to (userId: int, page: int = 1)
- 284 Change ReturnType of GetAnimations from Instance to Dictionary
- 285 Change Parameters of GetAnimations from (userId: int, page: int = 1) to (userId: int)
- 285 Change ReturnType of GetAnimations from Dictionary to Instance
- 131 Add GetAnimations
GetKeyframeSequence
Parameters (1) | ||
---|---|---|
assetId | ContentId | |
Returns (1) | ||
Instance |
Returns a KeyframeSequence from a given asset URL.
Security | PluginSecurity |
---|---|
Thread safety | Unsafe |
History 6
- 645 Change Parameters of GetKeyframeSequence from (assetId: Content) to (assetId: ContentId)
- 553 Change PreferredDescriptor of GetKeyframeSequence from to GetKeyframeSequenceAsync
- 462 Change ThreadSafety of GetKeyframeSequence from to Unsafe
- 321 Change Tags of GetKeyframeSequence from [] to [Deprecated]
- 321 Change Security of GetKeyframeSequence from None to PluginSecurity
- 47 Add GetKeyframeSequence
GetKeyframeSequenceAsync
Parameters (1) | ||
---|---|---|
assetId | ContentId | |
Returns (1) | ||
Instance |
GetKeyframeSequenceAsync returns a KeyframeSequence based on the specified assetId. The assetId must correspond to an animation. The function will yield until the KeyframeSequence is loaded from the website. Because this is a webcall it should wrapped in a pcall.
Thread safety | Unsafe |
---|
History 3
- 645 Change Parameters of GetKeyframeSequenceAsync from (assetId: Content) to (assetId: ContentId)
- 462 Change ThreadSafety of GetKeyframeSequenceAsync from to Unsafe
- 296 Add GetKeyframeSequenceAsync
GetKeyframeSequenceById
Parameters (2) | ||
---|---|---|
assetId | int64 | |
useCache | bool | |
Returns (1) | ||
Instance |
Returns a KeyframeSequence from the supplied assetId. Can optionally cache to reduce unnecessary loading freezes.
Security | PluginSecurity |
---|---|
Thread safety | Unsafe |
History 6
- 553 Change PreferredDescriptor of GetKeyframeSequenceById from to GetKeyframeSequenceAsync
- 462 Change ThreadSafety of GetKeyframeSequenceById from to Unsafe
- 322 Change Parameters of GetKeyframeSequenceById from (assetId: int, useCache: bool) to (assetId: int64, useCache: bool)
- 321 Change Tags of GetKeyframeSequenceById from [] to [Deprecated]
- 321 Change Security of GetKeyframeSequenceById from None to PluginSecurity
- 131 Add GetKeyframeSequenceById
GetMemStats
Parameters (0) | ||
---|---|---|
No parameters. | ||
Returns (1) | ||
Dictionary |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 2
- 462 Change ThreadSafety of GetMemStats from to Unsafe
- 378 Add GetMemStats
RegisterActiveKeyframeSequence
Parameters (1) | ||
---|---|---|
keyframeSequence | Instance | |
Returns (1) | ||
ContentId |
Generates a temporary asset ID from a KeyframeSequence that can be used for localized testing of an animation.
This function performs the same function to KeyframeSequenceProvider:RegisterKeyframeSequence() however this function generates an active:// URL instead of a hash.
The ID generated can be used in an Animation.AnimationId property for testing.
The asset ID generated by this function is temporary and cannot be used outside of Studio. Developers wishing to generate an asset ID that can be used online should upload the KeyframeSequence to Roblox.
Thread safety | Unsafe |
---|
History 3
- 645 Change ReturnType of RegisterActiveKeyframeSequence from Content to ContentId
- 462 Change ThreadSafety of RegisterActiveKeyframeSequence from to Unsafe
- 47 Add RegisterActiveKeyframeSequence
RegisterKeyframeSequence
Parameters (1) | ||
---|---|---|
keyframeSequence | Instance | |
Returns (1) | ||
ContentId |
Generates a temporary asset ID from a KeyframeSequence that can be used for localized testing of an animation.
This function performs the same function to KeyframeSequenceProvider:RegisterActiveKeyframeSequence() however this function generates a hash instead of an active:// URL.
The ID generated can be used for the Animation.AnimationId property to test animations.
The asset ID generated by this function is temporary and cannot be used outside of Studio. Developers wishing to generate an asset ID that can be used online should upload the KeyframeSequence to Roblox.
Thread safety | Unsafe |
---|
History 3
- 645 Change ReturnType of RegisterKeyframeSequence from Content to ContentId
- 462 Change ThreadSafety of RegisterKeyframeSequence from to Unsafe
- 47 Add RegisterKeyframeSequence