InsertService
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
InsertService は、Roblox ウェブサイトからアセットを挿入するために使用され、一般的に LoadAsset 機能です。
アセットを読み込むには、エクスペリエンスの読み込み者(ユーザーまたはグループ)にアクセスできる必要があります。エクスペリエンスが別の読み込みクリエーターによってアップロードされた場合、アセットのデータはアクセスできません。この
参照してください
- AssetService 、InsertService を使用してロードしたいアセットに関する情報を提供できます
概要
方法
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
指定された正確度値で新しい MeshPart を作成します。
カタログから無料のデカールのリストを取得します。
カタログから無料モデルのリストを取得します。
場所のクリエーターが作成したアセットの最新のアセットバージョンを返します。InsertService:LoadAssetVersion() と組み合わせて、モデルの最新バージョンをロードするために使用できます。ゲームが実行されている間、更新されても、モデルの最新バージョンをロードすることができます。
アセットを含む Model を返します。
Class.InsertService にアセットのバージョンを返す
プロパティ
AllowClientInsertModels
方法
CreateMeshPartAsync
指定された MeshPart と CollisionFidelity を持つ新しい RenderFidelity を作成します。 2>Class.MeshPart.MeshId2> はスクリプト
パラメータ
メッシュアセット ID。
Class.MeshPart.CollisionFidelity を設定します。
Class.MeshPart.RenderFidelity を設定します。
戻り値
GetFreeDecals
GetFreeDecals 関数は、カタログから無料の Decals を取得します。このメソッドの返し値は非常に奇妙であり、単一の テーブルを包含するテーブルで返されます。
それを説明する最良の方法は、返されたアレイのビジュアルを示すことです:
[1] = {CurrentStartIndex = 1, -- 入力するページによって変更される可能性があります。TotalCount = 21, -- 常に 21。Results = {-- ここのすべてのパラメーターは、偽の。アセットによって変更される可能性があります。[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2]、[3]、その他… [21] まで},}
このリストを反復するための例は、このページの下部に示されています。
さらに、Models を代わりに挿入したい場合は、InsertService:GetFreeModels() 機能を使用できます。
注意: ページアルグUMENTは 0 から始まります。つまり、ページ 1 = 0、ページ 2 = 1、などと続きます。
パラメータ
戻り値
単一の テーブル (返された無料デカール) を包含する テーブル。
コードサンプル
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
GetFreeModels 関数は、カタログから無料の Models を取得します。このメソッドの返型は非常に奇妙であり、単一の テーブルを包含するテーブルを返します。
それを説明する最良の方法は、返されたアレイのビジュアルを示すことです:
[1] = {CurrentStartIndex = 1, -- 入力するページによって変更される可能性があります。TotalCount = 21, -- 常に 21。Results = {-- ここのすべてのパラメーターは、偽の。アセットによって変更される可能性があります。[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2]、[3]、その他… [21] まで}}
このリストを反復するための例は、このページの下部に示されています。
さらに、無料の Decals を挿入したい場合は、InsertService:GetFreeDecals() 機能を使用できます。
パラメータ
戻り値
単一の テーブル (返された無料モデル) を包含する テーブル。
コードサンプル
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
場所のクリエーターが作成したアセットの最新のアセットバージョンを返します。InsertService:LoadAssetVersion() と組み合わせて、モデルの最新バージョンをロードするために使用できます。ゲームが実行されている間、更新されても、モデルの最新バージョンをロードすることができます。
パラメータ
戻り値
LoadAsset
LoadAsset 機能は、アセットのIDを取得し、Model にアセットを含むように返します。たとえば、この公開の Doge 、Model にアセット IDを含むように、1>2> 2574897262> を使用できます:
local assetId = 257489726local InsertService = game:GetService("InsertService")local model = InsertService:LoadAsset(assetId)model.Parent = workspace
モデルを提供するサーバーに問題が発生すると、この関数の呼び出しに失敗する可能性があります。そのため、モデルを提供するサーバーに pcall をラップして、これらのエラーをキャッチするのが一般的な良い方法です。
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
セキュリティチェック
この関数によって読み込まれるアセットは、ゲームのクリエーターまたは RoblRoblox(ロブロックス) によって作成されたか、所有済みでなければなりません。さらに、恶意のアセットのタイプ (Tシャツ、シャツ、パンツ、アバターアクセサリなど) は、公開されているすべてのゲームから読み込むことができます。
参照してください:
- AssetService:GetBundleDetailsAsync() 、バンドルに関連するアセットを見つけるために。
- プラグインの場合は、DataModel:GetObjects() を参照してください
パラメータ
ロードされているアセットのアイデントID。
戻り値
ロードされたアセットのインスタンス。
コードサンプル
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Class.InsertService にアセットのバージョンを返す
パラメータ
戻り値
コードサンプル
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace