3.3.1.3 Aktivace efektu

int LedsActivateEffect(String effectName, int priority);

Aktivuje efekt s danou prioritou. Jsou předdefinovány priority LED_PRIORITY_INFO=10, LED_PRIORITY_WARNING=20, LED_PRIORITY_CRITICAL=30. Vyšší priorita přebíjí nižší prioritu. To znamená, že pokud je již aktivní efekt pro zvolené LED diody s nižší prioritou a spustí se efekt s vyšší prioritou, bude se řídit efektem s vyšší prioritou. Pokud bude po skončení efektu s vyšší prioritou efekt s nižší stále trvat, stane se aktivním. Tímto způsobem se aplikace nemusí starat o sdílení LED s ostatními aplikacemi, stačí, když si aktivují efekt s adekvátní prioritou. Defaultně se automaticky aktivuje backlight notifikace modrou LED, která se aktivuje s prioritou 9.
Návratová hodnota je:

• IndoorTouch.RC_OK = 0;
• IndoorTouch.RC_ERR_CONN = -1; chyba při spojení s API démonem
• IndoorTouch.RC_ERR_NOTEXIST = -4; efekt s daným jménem neexistuje
• IndoorTouch.RC_ERR_DENIED = -7; notifikace jsou zakázány
• IndoorTouch.RC_ERR_MAXREACHED = -10; maximální počet spuštěných efektů byl překročen
• IndoorTouch.RC_ERR_PRIORITY = -11; je spuštěn efekt se stejnou maskou LED a stejnou prioritou