56 lines
1.3 KiB
Markdown
56 lines
1.3 KiB
Markdown
#api/syscall
|
|
|
|
The Asset API provides functions for reading and managing assets embedded in plugs.
|
|
|
|
### asset.readAsset(plugName, name, encoding?)
|
|
Reads an asset embedded in a plug.
|
|
|
|
Parameters:
|
|
- `plugName`: Name of the plug to read asset from
|
|
- `name`: Name of the asset to read
|
|
- `encoding`: Optional encoding type, either "utf8" (default) or "dataurl"
|
|
|
|
Returns the content of the asset in the requested encoding.
|
|
|
|
Example:
|
|
```lua
|
|
-- Read a text file as UTF-8
|
|
local text = asset.readAsset("myplug", "data.txt")
|
|
print(text)
|
|
|
|
-- Read an image as data URL
|
|
local imageData = asset.readAsset("myplug", "image.png", "dataurl")
|
|
print(imageData)
|
|
```
|
|
|
|
### asset.listFiles(plugName)
|
|
Lists all files in a plug.
|
|
|
|
Parameters:
|
|
- `plugName`: Name of the plug to list files from
|
|
|
|
Returns an array of FileMeta objects containing information about each file.
|
|
|
|
Example:
|
|
```lua
|
|
local files = asset.listFiles("myplug")
|
|
for _, file in ipairs(files) do
|
|
print(file.name, file.size)
|
|
end
|
|
```
|
|
|
|
### asset.getFileMeta(plugName, name)
|
|
Gets metadata about a specific file in a plug.
|
|
|
|
Parameters:
|
|
- `plugName`: Name of the plug
|
|
- `name`: Name of the file to get metadata for
|
|
|
|
Returns a FileMeta object containing information about the file.
|
|
|
|
Example:
|
|
```lua
|
|
local meta = asset.getFileMeta("myplug", "data.txt")
|
|
print("File size:", meta.size)
|
|
print("Last modified:", meta.lastModified)
|
|
``` |