InsertService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
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é
Propriétés
Méthodes
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Crée une nouvelle MeshPart avec les valeurs de fidélité spécifiées.
Récupère une liste d'autocollants gratuits du catalogue.
Récupère une liste de modèles gratuits dans le catalogue.
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.
Renvoie un Model contenant la contenu.
Renvoie un modèle inséré dans InsertService contenant la ressource avec l'ID de ressource donné.
Propriétés
AllowClientInsertModels
Méthodes
CreateMeshPartAsync
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
ID de ressource maillée.
Définir MeshPart.CollisionFidelity.
Définir MeshPart.RenderFidelity.
Retours
GetFreeDecals
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
Chaîne utilisée pour rechercher des images gratuites dans le catalogue.
Le numéro de page dans le catalogue à renvoyer.
Retours
Une seule table (de décalcomanies gratuites retournées) enveloppée dans une table.
Échantillons de code
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
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
Chaîne utilisée pour rechercher des images gratuites dans le catalogue.
Le numéro de page dans le catalogue à renvoyer.
Retours
Une seule table (de modèles gratuits retournés) enveloppée dans une table.
Échantillons de code
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
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
Retours
LoadAsset
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 = 257489726local 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 = 257489726local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)if success and model thenprint("Model loaded successfully")model.Parent = Workspaceelseprint("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 :
- AssetService:GetBundleDetailsAsync() , pour découvrir quelles ressources sont associées à un lot.
- Pour les plugins, voir DataModel:GetObjects()
Paramètres
L'ID de la ressource de la ressource chargée.
Retours
Une instance de la contenuchargée.
Échantillons de code
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Renvoie un modèle inséré dans InsertService contenant la ressource avec l'ID de ressource donné.
Paramètres
Retours
Échantillons de code
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace