get_active_material
Retrieve the active material from the AMS hardware, returning its type, color, remaining percentage, and temperature range. Falls back to selected/target tray metadata if the active tray is not reported.
Instructions
Get the filament physically active in the AMS hardware right now (Bambu Lab).
Reads live tray data from the AMS hardware. For the software-tracked
material (what was told to Kiln via ``set_material``), use
``get_material`` instead.
For Bambu Lab printers with an AMS, reads the active tray and
returns its type, colour, remaining percentage, and temperature
range. For non-Bambu printers (or printers without AMS), the
material is reported as ``"unknown"``.
``tray_now == "255"`` normally means external spool. On some
A1/AMS Lite reports it can also mean the active slot was not
reported even though AMS trays are present; in that case Kiln
falls back to selected/target tray metadata or returns the
loaded AMS candidates instead of claiming external spool.
Args:
printer_name: Named printer to query. Omit to use the
default printer.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| printer_name | No |