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 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é

Méthodes

Propriétés

AllowClientInsertModels

Non scriptable
Lecture parallèle

Méthodes

CreateMeshPartAsync

Rendement

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

meshId: ContentId

ID de ressources maillées.


Retours

Nouvelle instance MeshPart.

GetFreeDecals

Rendement

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

searchText: string

Chaîne utilisée pour rechercher des autocollants gratuits dans le catalogue.

pageNum: number

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

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 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

searchText: string

Chaîne utilisée pour rechercher des autocollants gratuits dans le catalogue.

pageNum: number

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

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 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

assetId: number

Retours

LoadAsset

Rendement

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 = 257489726
local 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 = 257489726
local InsertService = game:GetService("InsertService")
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 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 :

Paramètres

assetId: number

L'ID de la ressource chargée.


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

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

Paramètres

assetVersionId: number

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