AssetService

Crée un nouveau EditableImage . Par défaut, la résolution est définie à 512×512, mais vous pouvez spécifier une taille différente en utilisant la table d'options de la méthode.

Si le budget de mémoire modifiable spécifique au dispositif est épuisé, la création échoue et cette méthode renvoie nil .

Paramètres

Retours

Crée un nouveau, vide EditableMesh.Les vertex, triangles et leurs attributs peuvent être ajoutés dynamiquement à elle.Si le budget de mémoire modifiable spécifique au dispositif est épuisé, la création échouera et cette méthode renverra nil .

Paramètres

Retours

Télécharge une nouvelle ressource sur Roblox à partir de l'objet donné.

Actuellement, cette méthode ne peut être utilisée que dans les plugins locaux chargés et télécharger des ressources sans demander d'abord.

Paramètres

Retours

local AssetService = game:GetService("AssetService")

local editableMesh = AssetService:CreateEditableMesh()
-- ajouter des vertex, des faces et des uvs à la maille

local requestParameters = {
	CreatorId = 123,
	CreatorType = Enum.AssetCreatorType.User,
	Name = "My asset",
	Description = "a good asset",
}

local ok, result, idOrUploadErr = pcall(function()
	return AssetService:CreateAssetAsync(editableMesh, Enum.AssetType.Mesh, requestParameters)
end)

if not ok then
	warn(`error calling CreateAssetAsync: {result}`)
elseif result == Enum.CreateAssetResult.Success then
	print(`success, new asset id: {idOrUploadErr}`)
else
	warn(`upload error in CreateAssetAsync: {result}, {idOrUploadErr}`)
end

Télécharge une nouvelle version pour une ressource existante à partir de l'objet donné.

Actuellement, cette méthode ne peut être utilisée que dans les plugins locaux chargés et télécharger des ressources sans demander d'abord.

Paramètres

Retours

local AssetService = game:GetService("AssetService")

local assetIdToUpdate = 321
local model = Instance.new("Model")

local requestParameters = {
	CreatorId = 123,
	CreatorType = Enum.AssetCreatorType.User,
}

local ok, result, versionOrUploadErr = pcall(function()
	return AssetService:CreateAssetVersionAsync(model, Enum.AssetType.Model, assetIdToUpdate, requestParameters)
end)

if not ok then
	warn(`error calling CreateAssetVersionAsync: {result}`)
elseif result == Enum.CreateAssetResult.Success then
	print(`success, new asset version: {versionOrUploadErr}`)
else
	warn(`upload error in CreateAssetVersionAsync: {result}, {versionOrUploadErr}`)
end

Crée un nouvel objet EditableImage vierge de texture donnée.Les ID de texture non affectées comme rbxthumb:// sont pris en charge.Si vous utilisez une ressource d'image, elle doit être associée et/ou appartenir à un créateur de l'expérience, ou elle doit avoir été créée à l'intérieur de l'expérience.Si le budget de mémoire modifiable spécifique au dispositif est épuisé, la création échouera et cette méthode renverra nil .

Voir la documentation EditableImage pour des considérations spéciales lors de l'utilisation de cette API.

Paramètres

Retours

Renvoie un nouvel objet EditableMesh créé à partir d'un ID existant EditableMesh ou d'un maillage Content existant.Par défaut, un EditableMesh créé à partir de cette méthode sera de taille fixe afin que les données de maillage ne puissent être modifiées, ajoutées ni supprimées.Une taille fixe EditableMesh consomme moins de mémoire et devrait être préférée lorsque cela est possible.

Si le budget de mémoire modifiable spécifique au dispositif est épuisé, la création échouera et cette méthode renverra nil .

Voir les sections Activation de EditableMesh pour les expériences publiées et Permissions de pour des considérations spéciales lors de l'utilisation de cette API.

Paramètres

Retours

Cette méthode crée un MeshPart avec un CollisionFidelity spécifié, RenderFidelity et FluidFidelity .Comme MeshPart.MeshId est lu seul, cette méthode est pour créer un maillage avec n'importe quel ID de maillage via des scripts, sans avoir à cloner un maillage existant MeshPart.Il lance des erreurs si la création échoue.

Paramètres

Retours

Clone un lieu via le templatePlaceID donné et renvoie le PlaceId du nouvel endroit, que vous pouvez utiliser avec TeleportService.L'emplacement de clone s'affiche dans l'inventaire du créateur du lieu avec le nom et la description donnés.

Notez que l'emplacement du modèle doit avoir activé la copie de modèle via les paramètres d'emplacement. Vous ne pouvez pas utiliser cette méthode pour cloner des lieux que vous ne possédez pas.

L'utilisation fréquente de cette API n'est pas recommandée, notamment si les endroits créés contiennent des scripts, car mettre à jour le code dans un grand volume d'endroits devient rapidement impossible.Pour les mondes générés par l'utilisateur, envisagez de sérialiser les créations de l'utilisateur et de les enregistrer dans DataStores à la place.

Paramètres

Retours

Paramètres

Retours

Renvoie une série d'ID de ressources contenues dans un paquet spécifié.

Paramètres

Retours

Fournit des métadonnées pertinentes sur une source audio spécifique (artiste, titre, durée, type, etc.).

Paramètres

Retours

local AssetService = game:GetService("AssetService")
local SoundService = game:GetService("SoundService")

local trackIDs = {
	SoundService.Sound1.SoundId,
	SoundService.Sound2.SoundId,
	SoundService.Sound3.SoundId,
	SoundService.Sound4.SoundId,
}

local success, result = pcall(function()
	return AssetService:GetAudioMetadataAsync(trackIDs)
end)

if success then
	for i = 1, #trackIDs do
		local contentId = "rbxassetid://" .. result[i].AssetId
		if trackIDs[i] == contentId then
			print(result[i].Title, "by", result[i].Artist)
		else
			warn("No metadata fetched for requested asset #" .. tostring(i))
		end
	end
end

Cette fonction renvoie des détails du contenu du paquet spécifié.

Si l'ID du paquet n'existe pas, il lance HTTP 400 (Bad Request) . Si bundleId n'est pas convertible en entier, il lance Unable to cast string to int64 .

Paramètres

Retours

local AssetService = game:GetService("AssetService")

local BUNDLE_ID = 14

local success, result = pcall(function()
	return AssetService:GetBundleDetailsAsync(BUNDLE_ID)
end)

if success then
	print(result)
	--[[
	{
		["BundleType"] = "BodyParts",
		["Description"] = "The year is 5003, Battlebot 5000 must face his mightiest foe, or face becoming obsolete.",
		["Id"] = 14,
		["Items"] = {
			[1] = {...},
			[2] = {
				["Id"] = 1678225030,
				["Name"] = "SinisterBot 5001 Left Arm",
				["Type"] = "Asset"
			},
			[3] = {...},
			[4] = {...},
			[5] = {...},
			[6] = {...},
			[7] = {...}
		},
		["Name"] = "SinisterBot 5001"
	}
	--]]
end

Renvoie un objet StandardPages qui contient le nom et PlaceId les lieux à l'intérieur de l'expérience actuelle.

Retours

local AssetService = game:GetService("AssetService")

local placePages = AssetService:GetGamePlacesAsync()

while true do
	for _, place in placePages:GetCurrentPage() do
		print("Name:", place.Name)
		print("PlaceId:", place.PlaceId)
	end
	if placePages.IsFinished then
		break
	end
	placePages:AdvanceToNextPageAsync()
end

Permet la création d'actifs en expérience pour les utilisateurs en leur demandant de lancer un dialogue de publication.Lorsqu'il est appelé, il présente un dialogue à l'utilisateur, lui permettant d'entrer un nom, une description et de prévisualiser la ressource.Lors de la soumission, il enregistre la ressource dans l'inventaire de l'utilisateur.Ne peut être invoqué que du côté du serveur.

Paramètres

Retours

Paramètres

Retours

Enregistre l'état actuel de l'endroit. Gardez à l'esprit les directives et les restrictions suivantes :

• Cette méthode ne fonctionne que pour les lieux créés avec AssetService:CreatePlaceAsync() ou qui ont l'API activée via les paramètres du lieu.
• Cette méthode remplace l'état précédent de l'endroit. Pour annuler une sauvegarde, publiez une version plus ancienne de l'endroit.
• Il y a des cas où des sauvegardes peuvent se produire simultanément dans Studio et sur plusieurs serveurs d'expérience.L'ordre des sauvegardes se produit dans l'ordre dans lequel elles sont appelées.
• Une session de création d'équipe active dans les blocs Studio empêche toute sauvegarde de se produire.

Paramètres

Retours

Renvoie un objet AudioPages contenant le résultat de la recherche donnée. Ne retournera pas de champs avec des valeurs vides.

Notez que cette méthode a une faible limite de demande HTTP et peut générer une erreur, il doit donc toujours être emballé dans pcall() pour la gestion des erreurs.Les messages d'erreur possibles incluent :

<th>Raison</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>HTTP 429 (Trop de demandes)</td>

    <td><code>Class.AssetService:SearchAudio()</code> a été appelé trop de fois.</td>
  </tr>

  <tr>
    <td>Type inattendu pour les données, tableau attendu null obtenu</td>

    <td>L'argument clé a été filtré.</td>
  </tr>
</tbody>

Paramètres

Retours

local AssetService = game:GetService("AssetService")

local audioSearchParams = Instance.new("AudioSearchParams")
audioSearchParams.SearchKeyword = "happy"

local success, result = pcall(function()
	return AssetService:SearchAudio(audioSearchParams)
end)

if success then
	local currentPage = result:GetCurrentPage()
	for _, audio in currentPage do
		print(audio.Title)
	end
else
	warn("AssetService error: " .. result)
end

--[[ Returned data format
{
    "AudioType": string,
    "Artist": string,
    "Title": string,
    "Tags": {
        "string"
    },
    "Id": number,
    "IsEndorsed": boolean,
    "Description": string,
    "Duration": number,
    "CreateTime": string,
    "UpdateTime": string,
    "Creator": {
        "Id": number,
        "Name": string,
        "Type": number,
        "IsVerifiedCreator": boolean
    }
}
--]]