InsertService

사용되지 않는 항목 표시

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

만들 수 없음
서비스

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

자산을 로드하려면 경험을 로드하는 크리에이터에게 액세스할 수 있어야 하며, 사용자 또는 그룹일 수 있습니다.다른 크리에이터가 경험을 업로드하면 자산 데이터에 액세스할 수 없습니다.이 보안 확인대한 자세한 내용은 LoadAsset() 메서드를 참조하십시오.API 키나 다른 비밀을 로드하기 위해 이 서비스를 사용하면 안된다는 점에 유의하십시오. not 이 서비스를 사용하여 API 키나 다른 비밀을 로드해서는 안됩니다.대신 HttpService:GetSecret()

또한 참조하세요

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

요약

메서드

속성

AllowClientInsertModels

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

메서드

CreateMeshPartAsync

생성

지정된 MeshPartCollisionFidelityRenderFidelity 와 함께 새로운 를 생성합니다.읽기 전용인 MeshPart.MeshId 때문에, 기존 스크립트를 복제할 필요 없이 스크립트를 통해 MeshPart 를 만드는 방법입니다.생성이 실패하면 오류를 던집니다.

매개 변수

meshId: ContentId

메쉬 자산 ID.

기본값: ""
collisionFidelity: Enum.CollisionFidelity
기본값: ""
renderFidelity: Enum.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() 함수를 사용할 수 있습니다.

참고: 페이지 인수는 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

생성

장소 생성자가 만든 자산의 최신 자산 버전 ID를 반환합니다. Returns the latest AssetVersionId of an asset for assets created by the place 크리에이터.게임이 실행되는 동안 업데이트되더라도 최신 버전의 모델을 로드하기 위해 InsertService:LoadAssetVersion()와 결합할 수 있습니다.

매개 변수

assetId: number
기본값: ""

반환

LoadAsset

생성

LoadAsset 함수는 ID를 기준으로 자산을 가져와 Model 자산이 포함된 자산을 반환합니다.예를 들어, 자산 ID가 257489726인 이 공용 Doge를 로드하려면 다음을 사용할 수 있습니다.


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에서 생성되거나 소유되어야 합니다.또한 티셔츠, 셔츠, 바지 및 아바타 액세서리와 같은 무해한 자산 유형은 공개이기 때문에 모든 게임에서 로드할 수 있습니다.

참조하세요:

매개 변수

assetId: number

로드되는 자산의 자산 ID.

기본값: ""

반환

로드된 자산의 인스턴스.

코드 샘플

InsertService:LoadAsset

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

LoadAssetVersion

생성

지정된 자산버전ID를 포함하는 자산을 포함하는 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

이벤트