Oversikt
En kameraapp trenger ofte lys: et overvåkingskamera i et mørkt rom, en skanner, en videosamtale om natten. KlugTorch slår kameralyset (LED-en ved siden av bakkameraet) av og på mens kameraet fortsetter å kjøre.
KlugTorch oppdager først om enheten i det hele tatt har kameralys. Mange nettbrett og noen telefoner har ikke det, så en app kan ganske enkelt skjule lysknappen der.
Den fungerer ved siden av en live kamerastrøm. KlugTorch åpner ikke noe eget kamera, så den konkurrerer aldri med strømmen om kameraet.
Apper som strømmer med KlugMedia kan også bruke den innebygde lommelykt-kontrollen. KlugTorch brukes daglig i appene våre, vårt proof of concept.
Funksjoner
- Selvstendig: én ANE, ingen kjernebibliotek eller avhengige ANE-er å legge til
- Oppdager om enheten har kameralys
- Slå kameralyset av og på med ett kall
- Fungerer mens kameraet strømmer på iOS, uten avbrudd
- Leser gjeldende tilstand for lyset
- En endringshendelse etter hver omkobling, også når den mislykkes
- Ett API for iOS og Android
Støttede plattformer
På enheter uten kameralys, og på andre plattformer, returnerer isSupported false, slik at den samme koden kan bli værende i alle apper.
Kom i gang
Legg utvidelsen til i applikasjonsbeskrivelsen din:
<extensions>
<extensionID>com.klug.torch.Torch</extensionID>
</extensions>
Lyset sitter ved siden av bakkameraet, så bakkameraet bør være det aktive.
Kodeeksempler
Tre komplette flyter. on() og off() returnerer med en gang; en endringshendelse følger hvert kall, og mode forteller deg resultatet. Full dokumentasjon →
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 ); }
API-oversikt
| Torch.getInstance() | Returnerer den ene instansen. |
| isSupported | True bare hvis enheten har et brukbart kameralys: på iOS har standardkameraet (bak) en lommelykt, på Android 6+ har et bakvendt kamera en blits. |
| on() | Slår kameralyset på; en endringshendelse følger. |
| off() | Slår kameralyset av; en endringshendelse følger. |
| mode | True mens lyset er på. iOS leser kameraets lommelykttilstand; Android rapporterer tilstanden fra siste vellykkede on() / off(). |
Hendelser
| Event.CHANGE ("change") | Sendes etter hver on() og off(), også når lyset ikke kunne slås om. Les mode for resultatet. |
Kjøp KlugTorch
En årslisens for én AIR-applikasjon, med alle oppdateringer i 12 måneder. Etter betaling mottar du utvidelsen, ActionScript-biblioteket og dokumentasjonen på e-post, vanligvis innen én virkedag. Lisens og vilkår
- Lisens for én AIR-applikasjon
- Alle oppdateringer i 12 måneder
- Ingen støtte
- Lisens for én AIR-applikasjon
- Alle oppdateringer i 12 måneder
- Svar på e-post innen 7 dager
- Lisens for én AIR-applikasjon
- Alle oppdateringer i 12 måneder
- Svar på e-post innen 48 timer
Krav
| AIR SDK | 51.x (HARMAN) |
| iOS | iOS 17 eller nyere |
| Android | Android 6.0 (API 23) eller nyere |
| Tillatelser | Ingen egne |
| Maskinvare | Et kameralys ved siden av bakkameraet |