InsertService

非推奨を表示

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

作成できません
サービス

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

アセットを読み込むには、エクスペリエンスの読み込み者(ユーザーまたはグループ)にアクセスできる必要があります。エクスペリエンスが別の読み込みクリエーターによってアップロードされた場合、アセットのデータはアクセスできません。この

参照してください

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

概要

方法

プロパティ

AllowClientInsertModels

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

方法

CreateMeshPartAsync

イールド

指定された MeshPartCollisionFidelity を持つ新しい RenderFidelity を作成します。 2>Class.MeshPart.MeshId2> はスクリプト

パラメータ

meshId: ContentId

メッシュアセット ID。

collisionFidelity: Enum.CollisionFidelity

Class.MeshPart.CollisionFidelity を設定します。

renderFidelity: Enum.RenderFidelity

Class.MeshPart.RenderFidelity を設定します。


戻り値

新しい MeshPart インスタンス。

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、などと続きます。

パラメータ

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 関数は、カタログから無料の Models を取得します。このメソッドの返型は非常に奇妙であり、単一の テーブルを包含するテーブルを返します。

それを説明する最良の方法は、返されたアレイのビジュアルを示すことです:


[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

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


戻り値

単一の テーブル (返された無料モデル) を包含する テーブル。

コードサンプル

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

イールド

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

パラメータ

assetId: number

戻り値

LoadAsset

イールド

LoadAsset 機能は、アセットのIDを取得し、Model にアセットを含むように返します。たとえば、この公開の DogeModel にアセット IDを含むように、1>2> 2574897262> を使用できます:


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

モデルを提供するサーバーに問題が発生すると、この関数の呼び出しに失敗する可能性があります。そのため、モデルを提供するサーバーに pcall をラップして、これらのエラーをキャッチするのが一般的な良い方法です。


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

セキュリティチェック

この関数によって読み込まれるアセットは、ゲームのクリエーターまたは RoblRoblox(ロブロックス) によって作成されたか、所有済みでなければなりません。さらに、恶意のアセットのタイプ (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

イールド

Class.InsertService にアセットのバージョンを返す

パラメータ

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

イベント