AssetService

Erstellt ein neues EditableImage. Standardmäßig wird die Auflösung auf 512×512 festgelegt, aber du kannst eine andere Größe mit der Optionstabelle der Methode angeben.

Wenn das spezifische bearbeitbare Speicherbudget für das Gerät ausgegeben ist, scheitert die Erstellung und diese Methode gibt nil zurück.

Parameter

Rückgaben

Erstellt eine neue, leere EditableMesh.Vertiz, Dreieck und ihre Attribute können dynamisch zu ihr hinzugefügt werden.Wenn das spezifische bearbeitbare Speicherbudget für das Gerät erschöpft ist, scheitert die Erstellung und diese Methode gibt nil zurück.

Parameter

Rückgaben

Lädt ein neues Asset auf Roblox vom angegebenen Objekt hoch.

Derzeit kann diese Methode nur in lokal geladenen Plugins und Assets hochgeladen werden, ohne zuerst gefragt zu werden.

Parameter

Rückgaben

local AssetService = game:GetService("AssetService")

local editableMesh = AssetService:CreateEditableMesh()
-- füge vertices, gesichter und uvs zum netz hinzu

local requestParameters = {
	CreatorId = 123,
	CreatorType = Enum.AssetCreatorType.User,
	Name = "My asset",
	Description = "a good asset",
}

local ok, result, idOrUploadErr = pcall(function()
	return AssetService:CreateAssetAsync(editableMesh, Enum.AssetType.Mesh, requestParameters)
end)

if not ok then
	warn(`error calling CreateAssetAsync: {result}`)
elseif result == Enum.CreateAssetResult.Success then
	print(`success, new asset id: {idOrUploadErr}`)
else
	warn(`upload error in CreateAssetAsync: {result}, {idOrUploadErr}`)
end

Lädt eine neue Version für ein vorhandenes Asset aus dem angegebenen Objekt hoch.

Derzeit kann diese Methode nur in lokal geladenen Plugins und Assets hochgeladen werden, ohne zuerst gefragt zu werden.

Parameter

Rückgaben

local AssetService = game:GetService("AssetService")

local assetIdToUpdate = 321
local model = Instance.new("Model")

local requestParameters = {
	CreatorId = 123,
	CreatorType = Enum.AssetCreatorType.User,
}

local ok, result, versionOrUploadErr = pcall(function()
	return AssetService:CreateAssetVersionAsync(model, Enum.AssetType.Model, assetIdToUpdate, requestParameters)
end)

if not ok then
	warn(`error calling CreateAssetVersionAsync: {result}`)
elseif result == Enum.CreateAssetResult.Success then
	print(`success, new asset version: {versionOrUploadErr}`)
else
	warn(`upload error in CreateAssetVersionAsync: {result}, {versionOrUploadErr}`)
end

Erstellt ein neues EditableImage Objekt, das mit der angegebenen Textur gefüllt ist.Nicht-Asset-Texturen-IDs wie rbxthumb:// werden unterstützt.Wenn ein Bild-Asset verwendet wird, muss es mit und/oder im Besitz eines Erstellers des Erlebnisses sein oder es muss innerhalb des Erlebnisses erstellt worden sein.Wenn das für das Gerät spezifische bearbeitbare Speicherbudget erschöpft ist, scheitert die Erstellung und diese Methode gibt nil zurück.

Siehe die EditableImage.

Parameter

Rückgaben

Gibt ein neues Objekt zurück, das aus einer vorhandenen oder Mesh-ID erstellt wurde.Standardmäßig wird ein EditableMesh , das aus dieser Methode erstellt wurde, die Größe korrigiert, so dass Mesh-Daten nur modifiziert, nicht hinzugefügt oder entfernt werden können.Eine feste Größe EditableMesh verbraucht weniger Speicher und sollte bei möglichstem Einsatz bevorzugt werden.

Wenn das spezifische bearbeitbare Speicherbudget für das Gerät erschöpft ist, scheitert die Erstellung und diese Methode gibt nil zurück.

Siehe die Aktivierung von bearbeitbaren Meshes für veröffentlichte Erlebnisse und Berechtigungen Abschnitte von für besondere Überlegungen beim Einsatz dieser API.

Parameter

Rückgaben

Diese Methode erstellt ein MeshPart mit einem angegebenen CollisionFidelity, RenderFidelity und FluidFidelity.Da MeshPart.MeshId nur lesbar ist, ist diese Methode für die Erstellung eines Meshes mit einer beliebigen Meshing-ID durch Skripte gedacht, ohne ein vorhandenes MeshPart klonen zu müssen.Es wirft Fehler, wenn die Erstellung fehlschlägt.

Parameter

Rückgaben

Klont einen Ort durch die angegebene templatePlaceID und gibt die PlaceId des neuen Ortes zurück, die du mit TeleportService verwenden kannst.Der Klonplatz wird im Inventar des Erstellers des Ortes mit dem angegebenen Namen und der Beschreibung angezeigt.

Beachten Sie, dass der Platz für Vorlagen durch Platzoptionen aktiviert sein muss, um Kopieren von Vorlagen zu aktivieren. Sie können diese Methode nicht verwenden, um Orte zu klonen, die Sie nicht besitzen.

Es wird nicht empfohlen, diese API häufig zu verwenden, insbesondere wenn die erstellten Orte Skripte enthalten, da das Aktualisieren des Codes in einer großen Anzahl von Orten schnell unmöglich wird.Für von Benutzern generierte Welten, betrachte die Serialisierung von Benutzererstellungen und speichere sie stattdessen in DataStores .

Parameter

Rückgaben

Parameter

Rückgaben

Gibt eine Reihe von Asset-IDs zurück, die in einem bestimmten Paket enthalten sind.

Parameter

Rückgaben

Bietet relevante Metadaten über eine bestimmte Audioquelle (Künstler, Titel, Dauer, Art, etc.).

Parameter

Rückgaben

local AssetService = game:GetService("AssetService")
local SoundService = game:GetService("SoundService")

local trackIDs = {
	SoundService.Sound1.SoundId,
	SoundService.Sound2.SoundId,
	SoundService.Sound3.SoundId,
	SoundService.Sound4.SoundId,
}

local success, result = pcall(function()
	return AssetService:GetAudioMetadataAsync(trackIDs)
end)

if success then
	for i = 1, #trackIDs do
		local contentId = "rbxassetid://" .. result[i].AssetId
		if trackIDs[i] == contentId then
			print(result[i].Title, "by", result[i].Artist)
		else
			warn("No metadata fetched for requested asset #" .. tostring(i))
		end
	end
end

Diese Funktion gibt Details über den Inhalt des angegebenen Bündels zurück.

Wenn die Bündel-ID nicht existiert, wirft sie HTTP 400 (Bad Request) . Wenn bundleId nicht in ein Ganzzahl umwandelbar ist, wirft sie Unable to cast string to int64 .

Parameter

Rückgaben

local AssetService = game:GetService("AssetService")

local BUNDLE_ID = 14

local success, result = pcall(function()
	return AssetService:GetBundleDetailsAsync(BUNDLE_ID)
end)

if success then
	print(result)
	--[[
	{
		["BundleType"] = "BodyParts",
		["Description"] = "The year is 5003, Battlebot 5000 must face his mightiest foe, or face becoming obsolete.",
		["Id"] = 14,
		["Items"] = {
			[1] = {...},
			[2] = {
				["Id"] = 1678225030,
				["Name"] = "SinisterBot 5001 Left Arm",
				["Type"] = "Asset"
			},
			[3] = {...},
			[4] = {...},
			[5] = {...},
			[6] = {...},
			[7] = {...}
		},
		["Name"] = "SinisterBot 5001"
	}
	--]]
end

Gibt ein StandardPages Objekt zurück, das den Namen und PlaceId der Orte innerhalb der aktuellen Erfahrung enthält.

Rückgaben

local AssetService = game:GetService("AssetService")

local placePages = AssetService:GetGamePlacesAsync()

while true do
	for _, place in placePages:GetCurrentPage() do
		print("Name:", place.Name)
		print("PlaceId:", place.PlaceId)
	end
	if placePages.IsFinished then
		break
	end
	placePages:AdvanceToNextPageAsync()
end

Erlaubt die Erstellung von Assets in der Erfahrung für Benutzer, indem ein Veröffentlichungsdialog angezeigt wird.Wenn aufgerufen, präsentiert es dem Benutzer einen Dialog, um ihm zu ermöglichen, einen Namen, eine Beschreibung und eine Vorschau des Assets einzugeben.Nach dem Absenden speichert es das Asset im Inventar des Benutzers.Kann nur auf der Serverseite aufgerufen werden.

Parameter

Rückgaben

Parameter

Rückgaben

Speichert den aktuellen Zustand des Ortes. Beachte die folgenden Richtlinien und Einschränkungen:

• Diese Methode funktioniert nur für Orte, die mit AssetService:CreatePlaceAsync() erstellt wurden, oder die die API über die Einstellungen des Ortes aktiviert haben.
• Diese Methode überschreibt den vorherigen Zustand des Ortes. Um eine Speicherung rückgängig zu machen, veröffentliche eine ältere Version des Ortes.
• Es gibt Fälle, in denen Speicherungen gleichzeitig im Studio und auf mehreren Erlebnissерvern auftreten können.Die Reihenfolge der Speicherungen geschieht in der Reihenfolge, in der sie aufgerufen werden.
• Eine aktive Team-Erstellungs-Sitzung im Studio blockiert alle Speicherungen.

Parameter

Rückgaben

Gibt ein AudioPages Objekt zurück, das das Ergebnis der angegebenen Suche enthält. Wird keine Felder mit leeren Werten zurückgeben.

Beachten Sie, dass diese Methode ein niedriges HTTP-Anforderungslimit hat und Fehler werfen kann, so dass sie immer in pcall() für die Fehlerbehandlung eingepackt werden sollte.Mögliche Fehlermeldungen umfassen:

<th>Grund</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>HTTP 429 (Zu viele Anfragen)</td>

    <td><code>Class.AssetService:SearchAudio()</code> wurde zu oft aufgerufen.</td>
  </tr>

  <tr>
    <td>Unerwarteter Typ für Daten, erwartetes Array wurde null</td>

    <td>Das Schlüsselwort-Argument wurde gefiltert.</td>
  </tr>
</tbody>

Parameter

Rückgaben

local AssetService = game:GetService("AssetService")

local audioSearchParams = Instance.new("AudioSearchParams")
audioSearchParams.SearchKeyword = "happy"

local success, result = pcall(function()
	return AssetService:SearchAudio(audioSearchParams)
end)

if success then
	local currentPage = result:GetCurrentPage()
	for _, audio in currentPage do
		print(audio.Title)
	end
else
	warn("AssetService error: " .. result)
end

--[[ Returned data format
{
    "AudioType": string,
    "Artist": string,
    "Title": string,
    "Tags": {
        "string"
    },
    "Id": number,
    "IsEndorsed": boolean,
    "Description": string,
    "Duration": number,
    "CreateTime": string,
    "UpdateTime": string,
    "Creator": {
        "Id": number,
        "Name": string,
        "Type": number,
        "IsVerifiedCreator": boolean
    }
}
--]]