Yleiskatsaus
Kamerasovellus tarvitsee usein valoa: turvakamera pimeässä huoneessa, skanneri, videopuhelu yöllä. KlugTorch kytkee kameran valon (takakameran vieressä olevan LEDin) päälle ja pois kameran pysyessä käynnissä.
KlugTorch tunnistaa ensin, onko laitteessa lainkaan kameran valoa. Monessa tabletissa ja joissakin puhelimissa sellaista ei ole, joten sovellus voi yksinkertaisesti piilottaa valopainikkeensa siellä.
Se toimii live-kamerastriimin rinnalla. KlugTorch ei avaa omaa kameraa, joten se ei koskaan kilpaile striimin kanssa kamerasta.
KlugMedialla striimaavat sovellukset voivat käyttää myös sen sisäänrakennettua valon ohjausta. KlugTorch on päivittäisessä käytössä sovelluksissamme, todisteenamme toimivuudesta.
Ominaisuudet
- Itsenäinen: yksi ANE, ei ydinkirjastoa tai riippuvaisia ANE-laajennuksia lisättäväksi
- Tunnistaa, onko laitteessa kameran valo
- Kytke kameran valo päälle ja pois yhdellä kutsulla
- Toimii kameran striimatessa iOS:llä, ilman keskeytystä
- Lukee valon nykyisen tilan
- Muutostapahtuma jokaisen kytkennän jälkeen, myös epäonnistuessa
- Yksi rajapinta iOS:lle ja Androidille
Tuetut alustat
Laitteilla, joissa ei ole kameran valoa, ja muilla alustoilla isSupported palauttaa false, joten sama koodi voi pysyä jokaisessa sovelluksessa.
Aloitus
Lisää laajennus sovelluksesi descriptoriin:
<extensions>
<extensionID>com.klug.torch.Torch</extensionID>
</extensions>
Valo on takakameran vieressä, joten takakameran tulisi olla aktiivinen.
Koodiesimerkit
Kolme täydellistä esimerkkiä. on() ja off() palaavat heti; jokaista kutsua seuraa muutostapahtuma, ja mode kertoo tuloksen. Koko dokumentaatio →
import com.klug.torch.Torch; import flash.events.Event; var torch:Torch = Torch.getInstance(); // iOS: true if the default (back) camera has a torch. // Android 6+: true if a back-facing camera has a flash. // False on devices without a light and on other platforms. lightButton.visible = torch.isSupported; // lightButton: your app's toggle button
var wantLight:Boolean = false; torch.addEventListener( Event.CHANGE, onTorchChange ); // after every on() / off() function setLight( on:Boolean ):void { wantLight = on; if ( on ) torch.on(); else torch.off(); } function onTorchChange( e:Event ):void { // the event carries no detail: read mode for the current state lightButton.selected = torch.mode; if ( torch.mode != wantLight ) // the light could not be switched showMessage( "The light is not available right now." ); // your app }
function stopStreaming():void { if ( torch.mode ) setLight( false ); // first the light, then the camera stopCamera(); // your app's stream shutdown torch.removeEventListener( Event.CHANGE, onTorchChange ); }
Rajapintayleiskatsaus
| Torch.getInstance() | Palauttaa yksittäisen instanssin. |
| isSupported | True vain, jos laitteessa on käyttökelpoinen kameran valo: iOS:llä oletus- (taka)kamerassa on taskulamppu, Android 6+:lla takakamerassa on salama. |
| on() | Kytkee kameran valon päälle; muutostapahtuma seuraa. |
| off() | Kytkee kameran valon pois; muutostapahtuma seuraa. |
| mode | True valon palaessa. iOS lukee kameran taskulampun tilan; Android raportoi viimeisimmän onnistuneen on() / off()-kutsun tilan. |
Tapahtumat
| Event.CHANGE ("change") | Lähetetään jokaisen on()- ja off()-kutsun jälkeen, myös silloin, kun valoa ei voitu kytkeä. Lue tulos mode-arvosta. |
Osta KlugTorch
Vuosilisenssi yhdelle AIR-sovellukselle, kaikki päivitykset 12 kuukauden ajan. Maksun jälkeen saat laajennuksen, ActionScript-kirjaston ja dokumentaation sähköpostitse, yleensä yhden arkipäivän kuluessa. Lisenssi ja ehdot
- Lisenssi yhdelle AIR-sovellukselle
- Kaikki päivitykset 12 kuukauden ajan
- Ei tukea
- Lisenssi yhdelle AIR-sovellukselle
- Kaikki päivitykset 12 kuukauden ajan
- Vastaus sähköpostitse 7 päivän kuluessa
- Lisenssi yhdelle AIR-sovellukselle
- Kaikki päivitykset 12 kuukauden ajan
- Vastaus sähköpostitse 48 tunnin kuluessa
Vaatimukset
| AIR SDK | 51.x (HARMAN) |
| iOS | iOS 17 tai uudempi |
| Android | Android 6.0 (API 23) tai uudempi |
| Oikeudet | Ei omia |
| Laitteisto | Kameran valo takakameran vieressä |