InsertService

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

作成できません
サービス

InsertService は、通常 LoadAsset 機能で Roblox ウェブサイトからアセットを挿入するために使用されます。

アセットをロードするには、それをロードするエクスペリエンスのクリエイターにアクセスできる必要があり、ユークリエーターーまたはグループである必要があります。異なるクリエイターによってエクスペリエンスがアップロードされる場合、アセットデータにアクセスできないことがあります。このセキュリティチェックに関する詳細は、LoadAsset() メソッドを参照してください。API キーやその他の秘密のロードにこのサービスを使用してはならないことに注意してください しない 。代わりに HttpService:GetSecret() を使用します。

参照してください: See Also

  • AssetService , これは、InsertService を使用してロードしたいアセットに関する情報を提供できます

概要

方法

プロパティ

AllowClientInsertModels

スクリプト作成できません
並列読み取り

方法

CreateMeshPartAsync

イールド

指定された MeshPartCollisionFidelity および RenderFidelity で新しい を作成します。読み込み専用の MeshPart.MeshId があるため、既存のものをクローンする必要なく、スクリプトを介して MeshPart を作成する方法です。作成に失敗するとエラーが発生します。

パラメータ

meshId: ContentId

メッシュアセット ID。

既定値: ""
collisionFidelity: Enum.CollisionFidelity
既定値: ""
renderFidelity: Enum.RenderFidelity
既定値: ""

戻り値

新しい 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など

パラメータ

searchText: string

カタログで無料のデカールを検索するために使用される文字列。

既定値: ""
pageNum: number

カタログに戻すページ番号。

既定値: ""

戻り値

単一のテーブル (返された無料デカール) をテーブルに包んだもの。

コードサンプル

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

イールド

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() 関数を使用できます。

パラメータ

searchText: string

カタログで無料のデカールを検索するために使用される文字列。

既定値: ""
pageNum: number

カタログに戻すページ番号。

既定値: ""

戻り値

返された無料モデルの 1つのテーブル(テーブルに包まれている)。

コードサンプル

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

イールド

場所クリエーターによって作成されたアセットの最新のアセットバージョンIDを返します。ゲームが実行中に更新されても、InsertService:LoadAssetVersion() と組み合わせて最新バージョンのモデルをロードすることができます。

パラメータ

assetId: number
既定値: ""

戻り値

LoadAsset

イールド

LoadAsset 機能は、ID を指定してアセットを取得し、アセットを含む Model を返します。たとえば、この公開の Doge Model 、アセットIDが *257489726 * のものをロードするには、次のように使用できます:


local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")
local assetId = 257489726
local model = InsertService:LoadAsset(assetId)
model.Parent = Workspace

モデルを提供するサーバーに問題がある場合、この関数に呼び出しが失敗する可能性があります。そのため、この機能に対する呼び出しを pcall で包んで、この種のエラーをキャッチするのが一般的です。


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

安全性チェック

この関数によってロードされたアセットは、ゲームの作成者または Roblox によって 作成または所有 されている必要があります。さらに、Tシャツ、シャツ、パンツ、アバターアクセサリーなどの無害なアセットタイプは、公開されているため、どのゲームからもロードできます。

参照してください:

パラメータ

assetId: number

ロード中のアセットのアセットID。

既定値: ""

戻り値

ロードされたアセットのインスタンス。

コードサンプル

InsertService:LoadAsset

local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace

LoadAssetVersion

イールド

InsertService に挿入されたモデルを返し、指定されたアセットバージョンIDを含むアセットを含みます。

パラメータ

assetVersionId: number
既定値: ""

戻り値

コードサンプル

InsertService:LoadAssetVersion

local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace

イベント