Selleks, et arendajad saaksid luua ühtset kasutuskogemust pakkuvaid rakendusi, tutvustame täiendavaid esiplaaniteenuse tüüpe koos uute seotud eeskirjade piirangutega. Selles artiklis selgitatakse tulevasi esiplaaniteenuse nõudeid ja seda, kuidas Play Console'is esiplaaniteenuse teavet deklareerida. Selles tuuakse välja ka nõuded täisekraanil kuvatavate kavatsuse märguannete kasutamiseks.
Android 14 esiplaaniteenuse nõuded
Selleks et teha kindlaks, millised kasutusjuhtumid on esiplaaniteenuste jaoks sobivad, ja selgelt määratleda teie rakenduse taustatöö eesmärk, nõuavad Android 14 ja uuemad versioonid enne esiplaaniteenuse kasutamist järgmist.
- Deklareerige oma manifestis esiplaaniteenuse tüübid. Peate seda tegema iga esiplaaniteenuse puhul, mida kavatsete kasutada.
- Kui see on valitud tüübi puhul kohaldatav, deklareerige ja taotlege igale esiplaaniteenuse tüübile sobiv esiplaaniteenuse luba.
Meie seadmete ja võrkude väärkasutuse eeskirjade jaotises Esiplaaniteenuste load (FGS) kirjeldatakse üksikasjalikult esiplaaniteenuste kasutamiseks nõutavaid kriteeriume. Android 14 värskendamisel peate deklareerima esiplaaniteenuse tüübid.
Play Console'is esiplaaniteenuse teabe deklareerimine
Kui teie rakendused on suunatud Android 14-le ja uuematele versioonidele, peate deklareerima kõik esiplaaniteenuse tüübid, mida kasutate, uues deklaratsioonis lehel Rakenduse sisu (Eeskirjad > Rakenduse sisu) Play Console'is .
Iga deklareeritud esiplaaniteenuse tüübi korral peate tegema järgmist.
- Kirjeldage igat esiplaaniteenuse tüüpi kasutava rakenduse funktsioone.
- Kirjeldage mõju kasutajale, kui:
- süsteem lükkab ülesande edasi (ei käivitu kohe); ja/või
- süsteem katkestab ülesande (peatatakse ja/või taaskäivitatakse).
- Lisage link videole, mis demonstreerib iga esiplaaniteenuse funktsiooni. Video peaks näitama, mida kasutaja peab teie rakenduses funktsiooni käivitamiseks tegema.
- Valige iga esiplaaniteenuse tüübi jaoks konkreetne kasutusjuhtum. Saate valida valmis kasutusjuhtumite hulgast. Valige allolevas tabelis loetletud esiplaaniteenuste tüüpidele vastavate kasutusjuhtumite hulgast. See loend pole ammendav, nii et kui teie kasutusjuhtumit pole, saate selle sisestada käsitsi.
Teatud kasutusjuhtumite puhul soovitame kasutada alternatiivseid API-sid. Selliste kasutusjuhtumite ja soovitatavate alternatiivsete API-de loendi leiate Androidi arendajate saidilt.
Märkus. Allolev loend pole ammendav. Kasutusjuhtumite puhul, mida pole allpool kirjas, lugege esiplaaniteenuste lubade eeskirjadest, kas juurdepääs on esiplaaniteenuse jaoks sobilik.
| Esiplaaniteenuse tüüp | Kasutusjuhtumid | Kirjeldused ja näited |
|---|---|---|
TYPE_CAMERA |
Kaameravoo edastamine taustal | Kaamera taustal kasutamise jätkamine. Näiteks videovestlusrakendused, mis võimaldavad multitegumtööd. |
TYPE_CONNECTED_DEVICE |
Pidev andmeedastus välisseadmesse | Interaktsioonid välisseadmetega, sh andmeedastus, mis nõuab Bluetooth-, NFC-, IR-, USB- või võrguühendust. Näiteks kehal kantav seade, beebimonitor, peakomplekt, auto. |
TYPE_DATA_SYNC |
Võrguedastus: varundamine ja taastamine | Kasutamine konkreetselt kasutaja algatatud funktsioonide jaoks. Näiteks konkreetse foto valimine pilves varundamiseks, aga mitte kõigi uute fotode igapäevane automaatne varundamine. |
| Võrguedastus: üles- või allalaadimine | Näiteks andmete toomine, serveris töötlemine. | |
| Kohalik töötlemine: meedia transkodeerimine | Meediafailide (nt heli ja video) teisendamine ühest vormingust teise (nt sellised funktsioonid nagu videotöötlus). | |
| Kohalik töötlemine: importimine või eksportimine | Hõlmab failide üleviimist SD-kaardilt. | |
| Kohalik töötlemine: muu | Kasutamine konkreetselt kasutaja algatatavate toimingute, mitte regulaarsete süsteemi või serveri algatatavate toimingute jaoks. Näiteks krüptimine, suuruse muutmine. | |
TYPE_HEALTH |
Terviseandmete sünkroonimine | Treeningukategooriasse kuuluvate rakenduste terviseandmete sünkroonimine eri rakenduste vahel või seadmesisese jälgimise kaudu kogutud andmete koondamine. Näiteks sammuloendur, treeningupäevik. |
TYPE_LOCATION |
Asukohale taustal juurdepääsu värskendused: kasutaja algatatud asukohajagamine | Nt funktsioon Leia mu sõber, sõiduki tegevuste jälgimine. |
| Asukohale taustal juurdepääsu värskendused: navigeerimine | Näiteks sõites navigeerimise jätkamine Mapsis, sõitude jälgimine sõidujagamise puhul. | |
| Geotarastamine | Huvipakkuvaid piirkondi ümbritsevate parameetrite määratlemine. | |
TYPE_MEDIA_PLAYBACK |
Meediaesitus | Heli või video esitamise jätkamine taustal, sh voogesitus. |
| Kuvamine pilt pildis | Kui meediat esitatakse minimeerituna taustal. | |
TYPE_MEDIA_PROJECTION |
Meedia või sisu projitseerimine ja voogesitus või salvestamine MediaProjection API abil | Meedia projitseerimine mitteesmasele ekraanile või välisseadmetesse MediaProjection API-de abil (sh voogesitus). |
TYPE_MICROPHONE |
Helile taustal juurdepääs | Helisisu jäädvustamine, nt virtuaalassistendi häälkäsklused ilma salvestamiseta, häälsalvestised. |
TYPE_PHONE_CALL |
Helistamine: Cellular/VoiP/Telecom API-d | Mitmesuguste helistamisfunktsioonide tugi. |
TYPE_REMOTE_MESSAGING |
Teksti edastamine teise seadmesse | Aitab jätkata kasutaja sõnumsidetoiminguid, kui ta seadmeid vahetab. Näiteks võimaldab kasutajatel saata tekstsõnumeid veebikliendi kaudu, skannides QR-koodi ning luues ühenduse veebikliendi ja telefoni vahel. Pole piiratud SMS-iga. |
Deklaratsioon on saadaval alates novembrist 2023. Anname teile aega deklaratsiooni täitmiseks, tagasiside saamiseks ja vajadusel muudatuste tegemiseks.
Android 14 täisekraanil kavatsuse nõuded
Täisekraanikavatsusega märguandeid saab kasutada kõrge prioriteediga sõnumite jagamiseks, mis vajavad kasutaja viivitamatut tähelepanu. Tagamaks, et need load kehtiksid ainult asjakohaste ja kõrge prioriteediga kasutusjuhtumitel, kehtestame Android 14-s loa USE_FULL_SCREEN_INTENT kasutamisele piirangud. Selline märguannete piiramine tagab kasutajatele parema kasutuskogemuse.
Korduma kippuvad küsimused
Mis muutub Android 14 esiplaaniteenuste puhul?Kehtestame mitu uut esiplaaniteenuse tüüpi ja kohustuslik on deklareerida esiplaaniteenuse tüüp koos selle asjakohase esiplaaniteenuse loaga. Näiteks kui deklareerite esiplaaniteenuse tüübi „kaamera”, peate deklareerima ka loa FOREGROUND_SERVICE_CAMERA. Teie esiplaani kasutamine peab vastama ka teistele meie seadmete ja võrkude väärkasutuse eeskirjades sätestatud nõuetele.
Valige esiplaaniteenuse tüüp, mis sobib kõige paremini teie kavandatud esiplaaniteenuse kasutusega. Näiteks treeningrakendus, mis jälgib kasutaja treeningut, saab deklareerida esiplaaniteenuse tüübi „tervis”. Võite valida ka mitu esiplaaniteenuse tüüpi, kui see on teie rakenduse puhul kohaldatav.
Kui rakendused, mis on suunatud Android 14-le, kasutavad esiplaaniteenust, peavad arendajad deklareerima vastava esiplaaniteenuse loa selle konkreetse esiplaaniteenuse tüübi jaoks. Näiteks kui teie rakendus kasutab esiplaaniteenuse tüüpi „asukoht”, peate deklareerima loa FOREGROUND_SERVICE_LOCATION. Konkreetsele esiplaaniteenuse tüübile viitavad esiplaaniteenuse load on määratletud tavalubadena ja need antakse vaikimisi installimise ajal. Kasutajad ei saa neid lube tühistada.
Sõltuvalt esiplaaniteenuse tüübist võib olla täiendavaid süsteeminõudeid. Mõned neist võivad olla käitusaja load, mis nõuavad, et kasutajad annaksid loa, enne kui neid saab kasutada. Näiteks kui kasutate esiplaaniteenuse tüüpi „asukoht“, peab kasutaja andma ka loa ACCESS_COARSE_LOCATION või ACCESS_FINE_LOCATION. Värskeimat teavet vaadake dokumentatsioonist.
Piiratud juhtudel, kui teie kasutusjuhtum vastab muudele esiplaaniteenuse kasutamiseks vajalikele omadustele (nagu on kirjeldatud eeskirjades), võite deklareerida esiplaaniteenuse tüübi TYPE_SPECIAL_USE. Kõik esiplaaniteenuse tüübid kuuluvad ülevaatamisele.
Kasutaja tajutav tähendab, et kasutaja peaks teadma, et tema seadmes töötab esiplaaniteenuse ülesanne. Kasutajaid võib pidada teadlikuks, kui nad algatavad toimingu ise; näiteks võib kasutaja esitada laulu või jälgida jooksu. Teie rakendus võib kasutajaid ka teavitada töötavast esiplaaniteenusest, esitades seadme tegumiribal selge ja täpse märguande.
Kui teie rakendus on suunatud Androidi versioonile, mis on varasem kui Android 14, jätkake oma rakenduse manifestifaili elemendis <service> atribuudi android:foregroundServiceType kasutamist.
Kasutaja algatatud andmeedastustööd on loodud võrguüleste andmeedastuste lihtsustamiseks. Neil on piirangute jälgimine ja nad haldavad automaatselt äratuslukke. Esiplaaniteenuse tüüp dataSync võib hõlmata andmete kohalikku või võrgu kaudu edastamist ja andmete kohalikku töötlemist seadmes. Kui teie kasutusjuhtumiks on andmete edastamine võrgu (nt WiFi, mobiilside või Bluetoothi) kaudu vastuseks kasutaja selgesõnalisele taotlusele, soovitame kasutada esiplaaniteenuse tüübi dataSync asemel kasutaja algatatud andmeedastustööd.
Android 14 puhul lülitub USE_FULL_SCREEN_INTENT tavaloalt spetsiaalsele rakenduste juurdepääsu loale. Ainult need rakendused, mille põhifunktsiooniks on äratuse seadistamine või telefoni- või videokõnede vastuvõtmine, saavad automaatselt loa USE_FULL_SCREEN_INTENT. Põhifunktsioon on teie rakenduse peamine eesmärk, ilma milleta rakendus ei tööta või on kasutuskõlbmatu. Ka teised rakendused saavad seda luba kasutada, kuid ainult juhul, kui kasutaja on selle loa andnud.
Need muudatused jõustuvad 31. mail 2024.
Kui teie rakendus on suunatud Android 14-le ja uuematele versioonidele, saate Play Console’is lehel Rakenduse sisu (Eeskirjad > Rakenduse sisu) deklareerida, et teie rakendus on täisekraani kavatsuse põhifunktsiooniga rakendus. Deklaratsioon on saadaval alates aprillist 2024 ja anname teile aega selle täitmiseks.