InsertService
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
InsertService は、通常 LoadAsset 機能で Roblox ウェブサイトからアセットを挿入するために使用されます。
アセットをロードするには、それをロードするエクスペリエンスのクリエイターにアクセスできる必要があり、ユークリエーターーまたはグループである必要があります。異なるクリエイターによってエクスペリエンスがアップロードされる場合、アセットデータにアクセスできないことがあります。このセキュリティチェックに関する詳細は、LoadAsset() メソッドを参照してください。API キーやその他の秘密のロードにこのサービスを使用してはならないことに注意してください しない 。代わりに HttpService:GetSecret() を使用します。
参照してください: See Also
- AssetService , これは、InsertService を使用してロードしたいアセットに関する情報を提供できます
概要
方法
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
指定された忠実度値で新しい MeshPart を作成します。
カタログから無料のデカールのリストを取得します。
カタログから無料モデルのリストを取得します。
場所クリエーターによって作成されたアセットの最新のアセットバージョンIDを返します。ゲームが実行中に更新されても、InsertService:LoadAssetVersion() と組み合わせて最新バージョンのモデルをロードすることができます。
アセットを含む Model を返します。
InsertService に挿入されたモデルを返し、指定されたアセットバージョンIDを含むアセットを含みます。
プロパティ
AllowClientInsertModels
方法
CreateMeshPartAsync
指定された MeshPart と CollisionFidelity および RenderFidelity で新しい を作成します。読み込み専用の MeshPart.MeshId があるため、既存のものをクローンする必要なく、スクリプトを介して MeshPart を作成する方法です。作成に失敗するとエラーが発生します。
パラメータ
戻り値
GetFreeDecals
GetFreeDecals 機能は、カタログから無料の Decals リストを取得します。このメソッドの返却タイプは非常に奇妙で、1つのテーブルをテーブルに包んで返します。
それを説明する最良の方法は、返された配列のビジュアルを示すことです:
[1] = {CurrentStartIndex = 1, -- これは、入力したページによって異なります。TotalCount = 21, -- 常に 21。Results = {-- ここのすべてのパラメータは偽です。アセットによって変わる可能性があります。[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2]、[3]、など... [21] まで},}
このリストを反復する例が、このページの底に提供されました。
さらに、Models の代わりに挿入したい場合は、InsertService:GetFreeModels() 関数を使用できます。
注: ページ引数は 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 機能は、カタログから Free Models のリストを取得します。このメソッドの返却タイプは非常に奇妙で、1つのテーブルをテーブルに包んで返します。
それを説明する最良の方法は、返された配列のビジュアルを示すことです:
[1] = {CurrentStartIndex = 1, -- これは、入力したページによって異なります。TotalCount = 21, -- 常に 21。Results = {-- ここのすべてのパラメータは偽です。アセットによって変わる可能性があります。[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2]、[3]、など... [21] まで}}
このリストを反復する例が、このページの底に提供されました。
さらに、無料の Decals を挿入したい場合は、InsertService:GetFreeDecals() 関数を使用できます。
パラメータ
戻り値
返された無料モデルの 1つのテーブル(テーブルに包まれている)。
コードサンプル
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
場所クリエーターによって作成されたアセットの最新のアセットバージョンIDを返します。ゲームが実行中に更新されても、InsertService:LoadAssetVersion() と組み合わせて最新バージョンのモデルをロードすることができます。
パラメータ
戻り値
LoadAsset
LoadAsset 機能は、ID を指定してアセットを取得し、アセットを含む Model を返します。たとえば、この公開の Doge Model 、アセットIDが *257489726 * のものをロードするには、次のように使用できます:
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local model = InsertService:LoadAsset(assetId)model.Parent = Workspace
モデルを提供するサーバーに問題がある場合、この関数に呼び出しが失敗する可能性があります。そのため、この機能に対する呼び出しを pcall で包んで、この種のエラーをキャッチするのが一般的です。
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
安全性チェック
この関数によってロードされたアセットは、ゲームの作成者または Roblox によって 作成または所有 されている必要があります。さらに、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
InsertService に挿入されたモデルを返し、指定されたアセットバージョンIDを含むアセットを含みます。
パラメータ
戻り値
コードサンプル
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace