InsertService

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Création impossible
Service

InsertService est utilisé pour insérer des ressources depuis le site Web Roblox, généralement la fonction LoadAsset.

Pour charger une contenu, elle doit être accessible par le créateur de l'expérience qui la charge, qui peut être un utilisateur ou un groupe.Si une expérience doit être téléchargée par un créateur différent, les données de ressources ne seront pas accessibles.Voir la méthode LoadAsset() pour plus de détails sur ce vérifierde sécurité.Notez que vous ne devriez pas utiliser ce service pour charger des clés API ou d'autres secrets.Utilisez HttpService:GetSecret() à la place.

Voir aussi

  • AssetService , qui peut fournir des informations sur les ressources que vous pourriez vouloir charger en utilisant le service d'insertion

Résumé

Méthodes

Propriétés

AllowClientInsertModels

Non scriptable
Lecture parallèle

Méthodes

CreateMeshPartAsync

Rendement

Crée un nouveau MeshPart avec CollisionFidelity et RenderFidelity spécifiés.Comme MeshPart.MeshId est lu seul, c'est la façon de créer un MeshPart à travers des scripts sans avoir à cloner un existant.Il lance des erreurs si la création échoue.

Paramètres

meshId: ContentId

ID de ressource maillée.

Valeur par défaut : ""
collisionFidelity: Enum.CollisionFidelity
Valeur par défaut : ""
renderFidelity: Enum.RenderFidelity
Valeur par défaut : ""

Retours

Nouvelle instance MeshPart nouvelle.

GetFreeDecals

Rendement

La fonction GetFreeDecals récupère une liste de gratuits Decals à partir du catalogue.Le type de retour pour cette méthode est très étrange, car il renvoie une seule table enveloppée dans une table.

La meilleure façon de l'expliquer est de montrer une visualisation de l'array retournée :


[1] = {
CurrentStartIndex = 1, -- Cela peut varier en fonction de la page que vous saisissez.
TotalCount = 21, -- Toujours 21.
Results = {
-- Tous les paramètres ici sont pseudo. Ils peuvent varier en fonction de la contenu.
[1] = {
Name = "Asset Name",
AssetId = 0000000,
AssetVersionId = 0000000,
CreatorName = "Roblox",
},
-- [2], [3], et ainsi de suite... jusqu'à [21]
},
}

Un exemple d'itération sur cette liste a été fourni en bas de cette page.

De plus, si vous voulez insérer Models à la place, vous pouvez utiliser la fonction InsertService:GetFreeModels().

Remarque : L'argument de page commence à 0. Donc, la page 1 = 0, la page 2 = 1, etc.

Paramètres

searchText: string

Chaîne utilisée pour rechercher des images gratuites dans le catalogue.

Valeur par défaut : ""
pageNum: number

Le numéro de page dans le catalogue à renvoyer.

Valeur par défaut : ""

Retours

Une seule table (de décalcomanies gratuites retournées) enveloppée dans une table.

Échantillons de code

InsertService:GetFreeDecals

local InsertService = game:GetService("InsertService")
local page = unpack(InsertService:GetFreeDecals("Cats", 0)) -- Search for "Cats" on Page 1.
for i = 1, page.TotalCount do
local item = page.Results[i]
print("Item #" .. i)
for key, value in pairs(item) do
print(" " .. key .. ": " .. value)
end
end

GetFreeModels

Rendement

La fonction GetFreeModels récupère une liste de modèles gratuits Models à partir du catalogue.Le type de retour pour cette méthode est très étrange, car il renvoie une seule table enveloppée dans une table.

La meilleure façon de l'expliquer est de montrer une visualisation de l'array retournée :


[1] = {
CurrentStartIndex = 1, -- Cela peut varier en fonction de la page que vous saisissez.
TotalCount = 21, -- Toujours 21.
Results = {
-- Tous les paramètres ici sont pseudo. Ils peuvent varier en fonction de la contenu.
[1] = {
Name = "Asset Name",
AssetId = 0000000,
AssetVersionId = 0000000,
CreatorName = "Roblox",
}
-- [2], [3], et ainsi de suite... jusqu'à [21]
}
}

Un exemple d'itération sur cette liste a été fourni en bas de cette page.

De plus, si vous souhaitez insérer gratuitement Decals, vous pouvez utiliser la fonction InsertService:GetFreeDecals().

Paramètres

searchText: string

Chaîne utilisée pour rechercher des images gratuites dans le catalogue.

Valeur par défaut : ""
pageNum: number

Le numéro de page dans le catalogue à renvoyer.

Valeur par défaut : ""

Retours

Une seule table (de modèles gratuits retournés) enveloppée dans une table.

Échantillons de code

InsertService:GetFreeModels

local InsertService = game:GetService("InsertService")
local page = unpack(InsertService:GetFreeModels("Cats", 0)) -- Search for "Cats" on Page 1.
for i = 1, page.TotalCount do
local item = page.Results[i]
print("Item #" .. i)
for key, value in pairs(item) do
print(" " .. key .. ": " .. value)
end
end

GetLatestAssetVersionAsync

Rendement

Renvoie la dernière version d'ID de ressource d'une ressource créée par le créateur de lieu.Peut être utilisé en combinaison avec InsertService:LoadAssetVersion() pour charger la dernière version d'un modèlisation, même si elle est mise à jour pendant que le jeu fonctionne.

Paramètres

assetId: number
Valeur par défaut : ""

Retours

LoadAsset

Rendement

La fonction LoadAsset récupère une ressource donnée par son ID et renvoie une ressource Model contenant la contenu.Par exemple, pour charger ce public DogeModel , qui a l'ID de ressource *257489726 * , vous pouvez utiliser :


local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")
local assetId = 257489726
local model = InsertService:LoadAsset(assetId)
model.Parent = Workspace

Les appels à cette fonction peuvent échouer si un serveur fournissant un modèle a des problèmes.En tant que tel, il est généralement une bonne idée d'envelopper les appels à cette fonction dans pcall pour capturer ce genre d'erreurs.


local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")
local assetId = 257489726
local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)
if success and model then
print("Model loaded successfully")
model.Parent = Workspace
else
print("Model failed to load!")
end

Vérification de sécurité

Une ressource chargée par cette fonction doit être créée ou possédée par le créateur du jeu ou Roblox.En outre, les types de ressources bénignes tels que les t-shirts, les chemises, les pantalons et les accessoires d'avatar sont chargés à partir de n'importe quel jeu car ils sont public/publique.

Voir aussi :

Paramètres

assetId: number

L'ID de la ressource de la ressource chargée.

Valeur par défaut : ""

Retours

Une instance de la contenuchargée.

Échantillons de code

InsertService:LoadAsset

local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace

LoadAssetVersion

Rendement

Renvoie un modèle inséré dans InsertService contenant la ressource avec l'ID de ressource donné.

Paramètres

assetVersionId: number
Valeur par défaut : ""

Retours

Échantillons de code

InsertService:LoadAssetVersion

local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace

Évènements