Útmutatók

Parancsok

A Komod nyilvános metódusa [KomodCommand] attribútummal a felületről hívható, amíg a példány fut. Ez való egyszeri műveletekre (kalibrálás, nullázás, mentés); folyamatos adatra portot használj.

[KomodCommand("reset")]
public async Task<ResetResult> ResetAsync(CancellationToken ct) { … }

Szabályok

• A név elhagyható: ilyenkor a metódusnév az Async nélkül, camelCase alakban.
• Legfeljebb egy argumentum (JSON-ból deszerializálva) és egy CancellationToken lehet.
• A visszatérés: Task, Task<T>, ValueTask(<T>), void vagy érték; JSON-ként megy vissza.
• Felhasználónak szóló hibához KomodCommandException-t dobj: magyar szöveggel, vagy fordítható szöveggel (Text("kulcs", "magyar szöveg"), lásd Többnyelvű Komod). Ez jelenik meg a felületen.
• RequiresAdmin = true: csak Admin hívhatja. Alapból Operator is.

Hívás a felületről

var result = await Kofa.InvokeAsync<ResetResult>(InstanceId, "reset");
// vagy: await InvokeCommandAsync("reset");

Argumentummal: await Kofa.InvokeAsync(InstanceId, "calibrate", new { offset = 1.5 }).

A parancs a futó példányon hajtódik végre. Ha a példány nem fut, a hívás hibával tér vissza.