InsertService

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음
서비스

InsertService는 Roblox 웹사이트에서 자산을 삽입하는 데 사용됩니다. 일반적으로 LoadAsset 함수입니다.

자산을 로드하려면 경험 로더의 크리에이터가 자산을 액세스할 수 있어야 합니다, 즉 사용자 또는 그룹일 수 있습니다. 경험이 다른 크리에이터에 의해 업로드되면 자산 데이터에 액세스할

또 보기

  • AssetService, 삽입 서비스를 사용하여 로드하려는 자산에 대한 정보를 제공할 수 있습니다.

요약

메서드

속성

AllowClientInsertModels

스크립팅할 수 없음
병렬 읽기

메서드

CreateMeshPartAsync

생성

Class.MeshPart 생성을 위해 지정된 CollisionFidelityRenderFidelity 을 사용합니다. 1>Class.MeshPart.MeshId1> 는 읽기 전

매개 변수

meshId: ContentId

메쉬 자산 ID.


반환

새로운 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() 함수를 사용할 수 있습니다.

참고:: 페이지 인수는 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가 지정된 경우 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

보안 검색

이 함수로 로드된 자산은 게임 제작자나 Roblox가 소유하거나 생성한 자산이어야 합니다. 또한, 공개된 게임 자산 유형(티셔츠, 셔츠, 바지 및 아바타 액세서리)은 모든 게임에서 로드할 수 있습니다.

또한 참조하십시오.

매개 변수

assetId: number

로드 중인 자산의 자산 ID.


반환

로드된 자산의 인스턴스입니다.

코드 샘플

InsertService:LoadAsset

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

LoadAssetVersion

생성

자산VersionId를 지정한 자산을 포함하는 모델을 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

이벤트