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 du site Web Roblox, généralement la fonction LoadAsset.
Pour charger une contenu, il doit être accessible par le créateur de l'expérience qui la charge, qui peut être un utilisateur ou un groupe. Si une ressource est chargée par un autre créateur, les données de la ressource ne seront pas accessibles. Voir la méthode LoadAsset() pour plus de détails sur ce test de sécurité. Notez que vous ne dev
Voir aussi
- AssetService , qui peut fournir des informations sur les ressources que vous voudrez peut-être 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 des valeurs de fidélité spécifiées.
Récupère une liste de free Decals du catalogue.
Récupère une liste de modèles gratuits dans le catalogue.
Renvoie la dernière version de AssetVersionId d'une ressource pour les ressources créées par le créateur du 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 s'exécute.
Retourne un Model contenant la contenu.
Retourne un modèle inséré dans InsertService contenant la ressource avec l'identifiant de ressource donné.
Propriétés
AllowClientInsertModels
Méthodes
CreateMeshPartAsync
Crée une nouvelle MeshPart avec CollisionFidelity et RenderFidelity . Étant donné que 1> Class.MeshPart.MeshId1> est lu seulement, c'est la faç
Paramètres
ID de ressources maillées.
Définir MeshPart.CollisionFidelity .
Définir MeshPart.RenderFidelity .
Retours
GetFreeDecals
La fonction GetFreeDecals récupère une liste de Class.Decal|Decals gratuits du catalogue. Le type de retour pour cette méthode est très étrange, car il renvoie une table unique en tableau.
La meilleure façon de l'expliquer est de montrer visuellement l' array renvoyé :
[1] = {CurrentStartIndex = 1, -- Cela peut varier en fonction de la page que vous entrez.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 pour itérer 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 : Le paramètre de page commence à 0. Donc la page 1 = 0, la page 2 = 1, etc.
Paramètres
Chaîne utilisée pour rechercher des autocollants gratuits dans le catalogue.
Le numéro de page dans le catalogue pour renvoyer.
Retours
Une seule table (de décalques gratuites retournées) entourée d'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 dans le catalogue. Le type de retour pour cette méthode est très étrange, car il renvoie une table unique en tableau.
La meilleure façon de l'expliquer est de montrer visuellement l' array renvoyé :
[1] = {CurrentStartIndex = 1, -- Cela peut varier en fonction de la page que vous entrez.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 pour itérer sur cette liste a été fourni en bas de cette page.
De plus, si vous souhaitez insérer des Decals, vous pouvez utiliser la fonction InsertService:GetFreeDecals().
Paramètres
Chaîne utilisée pour rechercher des autocollants gratuits dans le catalogue.
Le numéro de page dans le catalogue pour renvoyer.
Retours
Une table (de modèles gratuits retournés) entouré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 de AssetVersionId d'une ressource pour les ressources créées par le créateur du 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 s'exécute.
Paramètres
Retours
LoadAsset
La fonction LoadAsset récupère une ressource donné son ID et renvoie un Model contenant la contenu. Par exemple, pour charger cette publicité DogeModel , qui contient l'ID de la ressource 1>2> 257489726 2> >1>, vous pouvez utiliser :
local assetId = 257489726local InsertService = game:GetService("InsertService")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'emboîter les appels à cette fonction dans pcall pour attraper ces types d'erreurs.
local assetId = 257489726local InsertService = game:GetService("InsertService")local 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 la 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. De plus, les types de ressources bénins tels que les t-shirts, les chemises, les pantalons et les accessoires d'avatar sont chargables à partir de n'importe quel jeu car ils sont public/publique.
Voir aussi :
- AssetService:GetBundleDetailsAsync() , pour trouver les ressources associées à un lot.
- Pour les plugins, voir DataModel:GetObjects()
Paramètres
L'ID 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
Retourne un modèle inséré dans InsertService contenant la ressource avec l'identifiant 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