ContentProvider

Show Deprecated
Not Creatable
Service
Not Replicated

Service that is used to load content, or assets, into a game.

The service's main use is to preload assets into a game. When a new asset such as a Decal or Sound is used in a game, Roblox will load the content associated with it from Roblox servers. In some cases, this can be undesirable for developers as it can lead to a delay before the content loads into the game.

With ContentProvider, developers can preload assets using the ContentProvider:PreloadAsync() function. Another useful property is ContentProvider.RequestQueueSize, which can be used to measure what proportion of assets in the request queue have been downloaded.

Code Samples

ContentProvider
1local ContentProvider = game:GetService("ContentProvider")

2

3local LOGO_ID = "rbxassetid://658743164"

4local PAGE_TURN_ID = "rbxassetid://12222076"

5

6local decal = Instance.new("Decal")

7decal.Texture = LOGO_ID

8

9local sound = Instance.new("Sound")

10sound.SoundId = PAGE_TURN_ID

11

12local assets = { decal, sound }

13

14ContentProvider:PreloadAsync(assets)

15

16print("All assets loaded.")

Summary

Properties

BaseUrl: string

Used by the ContentProvider to download assets from the Roblox website.

READ ONLY
NOT REPLICATED
RequestQueueSize: number

Gives the number of items in ContentProvider's request queue that need to be downloaded.

READ ONLY
NOT REPLICATED

Events

AssetFetchFailed(assetId: Content): RBXScriptSignal  

Methods

CalculateNumTrianglesInMeshSync(meshId: string): number  

GetDetailedFailedRequests(): Array  

GetFailedRequests(): Array  

ListEncryptedAssets(): Array  

RegisterDefaultEncryptionKey(encryptionKey: string): nil  

RegisterDefaultSessionKey(sessionKey: string): nil  

RegisterEncryptedAsset(assetId: Content, encryptionKey: string): nil  

RegisterSessionEncryptedAsset(contentId: Content, sessionKey: string): nil  

SetBaseUrl(url: string): nil  

Sets ContentProvider.BaseUrl, which is used by CoreScripts to interact with the web APIs.

UnregisterDefaultEncryptionKey(): nil  

UnregisterEncryptedAsset(assetId: Content): nil  

CalculateNumTrianglesInMesh(meshId: string): number  YIELDS

PreloadAsync(contentIdList: Array, callbackFunction: function): nil  YIELDS

Yields until all of the assets associated with the given Instances have loaded.

Properties

BaseUrl

string
Read Only
Not Replicated
Read Parallel

Used by the ContentProvider to download assets from the Roblox website.

This URL points to a Roblox hosted website from which assets are downloaded and is pulled from the AppSettings.xml file, located in the version-hash folder.

It is possible to overwrite this property using the ContentProvider:SetBaseUrl() function in the command bar; however, this is not recommended and may cause asset loading issues.

RequestQueueSize

number
Read Only
Not Replicated
Read Parallel

Gives the number of items in ContentProvider's request queue that need to be downloaded.

Items are added to the client's request queue when an asset is used for the first time or ContentProvider:PreloadAsync() is called.

Developers are advised not to use RequestQueueSize to create loading bars. This is because the queue size can both increase and decrease over time as new assets are added and downloaded. Developers looking to display loading progress should load assets one at a time (see example below).

Events

AssetFetchFailed

Parameters

assetId: Content

Methods

CalculateNumTrianglesInMeshSync

number
Roblox Script Security

Parameters

meshId: string

Returns

number

GetDetailedFailedRequests

Array
Roblox Script Security

Returns

Array

GetFailedRequests

Array
Roblox Script Security

Returns

Array

ListEncryptedAssets

Array

Returns

Array

RegisterDefaultEncryptionKey

nil

Parameters

encryptionKey: string

Returns

nil

RegisterDefaultSessionKey

nil

Parameters

sessionKey: string

Returns

nil

RegisterEncryptedAsset

nil

Parameters

assetId: Content
encryptionKey: string

Returns

nil

RegisterSessionEncryptedAsset

nil

Parameters

contentId: Content
sessionKey: string

Returns

nil

SetBaseUrl

nil
Local User Security

Sets ContentProvider.BaseUrl, which is used by CoreScripts to interact with the web APIs.

This function is restricted and intended for internal Roblox scripts. Although it can be used from the command line in Roblox Studio, developers are advised not to do this as it may prevent assets from loading.

Parameters

url: string

The base URL to be set.


Returns

nil

Code Samples

ContentProvider:SetBaseUrl
1local ContentProvider = game:GetService("ContentProvider")

2

3ContentProvider:SetBaseUrl("http://www.roblox.com/")

UnregisterDefaultEncryptionKey

nil

Returns

nil

UnregisterEncryptedAsset

nil

Parameters

assetId: Content

Returns

nil

CalculateNumTrianglesInMesh

number
Yields
Roblox Script Security

Parameters

meshId: string

Returns

number

PreloadAsync

nil
Yields

Yields until all of the assets associated with the given Instances have loaded and takes an array of Instances as a parameter.

This can be used to pause a script and not use content until it is certain that the content has been loaded into the game.

When the function is called, the engine will go through the array of instances (and all of the descendants of the passed-in instances). If any of the instances have a property that defines a link to content, such as a Decal or a Sound, then the function will attempt to load the asset from the Roblox website. If any of the assets fail to load, an error message will appear in the output, but the PreloadAsync function itself will not error and will continue executing until it has processed each passed-in instance.

Parameters

contentIdList: Array

An array of Instances to be preloaded.

callbackFunction: function

The Lua function to be called on completion of each asset request.

Default Value: "nil"

Returns

nil

No return.

Code Samples

Preloading Assets
1local ContentProvider = game:GetService("ContentProvider")

2

3local sound = Instance.new("Sound")

4sound.SoundId = "rbxassetid://9120386436"

5local decal = Instance.new("Decal")

6decal.Texture = "rbxassetid://5447528495"

7

8local assets = {

9	decal,

10	sound,

11	"rbxassetid://5173222739",

12	"rbxthumb://type=Avatar&w=100&h=100&id=269323",

13}

14

15-- Preload the content and time it

16local startTime = os.clock()

17ContentProvider:PreloadAsync(assets)

18local deltaTime = os.clock() - startTime

19print(("Preloading complete, took %.2f seconds"):format(deltaTime))