A partir do Android 14 (nível 34 da API), é necessário declarar um tipo de serviço
adequado para cada serviço em primeiro plano. É necessário declarar o tipo de serviço no
manifesto do app e solicitar a permissão de serviço em primeiro plano adequada para
esse tipo, além da permissão FOREGROUND_SERVICE. Dependendo do
tipo de serviço em primeiro plano, talvez seja necessário solicitar permissões de execução
antes de iniciar o serviço.
Câmera
- 要在清单中的
android:foregroundServiceType下声明的前台服务类型 camera- 要在清单中声明的权限
FOREGROUND_SERVICE_CAMERA- 要传递给
startForeground()的常量 FOREGROUND_SERVICE_TYPE_CAMERA- 运行时前提条件
请求并获得
CAMERA运行时权限- 说明
继续在后台访问相机,例如支持多任务的视频聊天应用。
Dispositivo conectado
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTypeconnectedDevice- Permissão a ser declarada no manifesto
FOREGROUND_SERVICE_CONNECTED_DEVICE- Constante para transmitir para
startForeground() FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE- Pré-requisitos do ambiente de execução
Pelo menos uma das condições a seguir precisa ser verdadeira:
Declare pelo menos uma das permissões a seguir no manifesto:
Solicitar e receber pelo menos uma das seguintes permissões de execução:
- Descrição
Interações com dispositivos externos que exigem uma conexão Bluetooth, NFC, IR, USB ou de rede.
- Alternativas
Se o app precisar fazer transferências de dados contínuas para um dispositivo externo, use o gerenciador de dispositivo complementar. Use a API de presença de dispositivo complementar para ajudar o app a continuar em execução enquanto o dispositivo complementar está no alcance.
Se o app precisar procurar dispositivos Bluetooth, use a API de verificação de Bluetooth.
Sincronização de dados
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTypedataSync- Permissão para declarar no manifesto
FOREGROUND_SERVICE_DATA_SYNC- Constante a ser transmitida para
startForeground() FOREGROUND_SERVICE_TYPE_DATA_SYNC- Pré-requisitos do ambiente de execução
- Nenhum
- Descrição
Operações de transferência de dados, como as seguintes:
- Upload ou download de dados
- Operações de backup e restauração
- Operações de importação ou exportação
- Busca de dados
- Processamento local de arquivos
- Transferência de dados entre um dispositivo e a nuvem por uma rede
- Alternativas
Consulte Alternativas aos serviços em primeiro plano de sincronização de dados para mais informações.
Saúde
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTypehealth- Permissão a ser declarada no manifesto
FOREGROUND_SERVICE_HEALTH- Constante para transmitir para
startForeground() FOREGROUND_SERVICE_TYPE_HEALTH- Pré-requisitos do ambiente de execução
Pelo menos uma das condições a seguir precisa ser verdadeira:
Declare a permissão
HIGH_SAMPLING_RATE_SENSORSno manifesto.Solicitar e receber pelo menos uma das seguintes permissões de execução:
BODY_SENSORSna API 35 e anterioresREAD_HEART_RATEREAD_SKIN_TEMPERATUREREAD_OXYGEN_SATURATIONACTIVITY_RECOGNITION
- Descrição
Todos os casos de uso de longa duração que oferecem suporte a apps na categoria fitness, como apps de monitoramento de atividade física.
Local
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTypelocation- Permissão a ser declarada no manifesto
FOREGROUND_SERVICE_LOCATION- Constante para transmitir para
startForeground() FOREGROUND_SERVICE_TYPE_LOCATION- Pré-requisitos do ambiente de execução
O usuário precisa ter ativado os serviços de localização, e o app precisa ter pelo menos uma das seguintes permissões de execução:
- Descrição
Casos de uso de longa duração que exigem acesso à localização, como navegação e compartilhamento de local.
- Alternativas
Se o app precisar ser acionado quando o usuário chegar a locais específicos, use a API Geofence.
Mídia
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTypemediaPlayback- Permissão para declarar no manifesto
FOREGROUND_SERVICE_MEDIA_PLAYBACK- Constante a ser transmitida para
startForeground() FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK- Pré-requisitos do ambiente de execução
- Nenhum
- Descrição
Continue reproduzindo áudio ou vídeo em segundo plano. Suporte à funcionalidade de gravação de vídeo digital (DVR) no Android TV.
- Alternativas
Se você estiver mostrando um vídeo picture-in-picture, use o modo picture-in-picture.
Mídia em processamento
- 要在清单中的以下位置声明的前台服务类型
android:foregroundServiceTypemediaProcessing- 在清单中声明的权限
FOREGROUND_SERVICE_MEDIA_PROCESSING- 要传递给
startForeground()的常量 FOREGROUND_SERVICE_TYPE_MEDIA_PROCESSING- 运行时前提条件
- 无
- 说明
用于对媒体资源执行耗时的操作(例如将媒体转换为其他格式)的服务。系统允许此服务运行的时间有限;在正常情况下,此时限为每天 24 小时中的 6 小时。(此限制由应用的所有
mediaProcessing前台服务共享。)在以下情况下,您的应用应手动停止媒体处理服务:
- 当转码操作完成或达到失败状态时,让服务调用
Service.stopForeground()和Service.stopSelf()以完全停止服务。
- 当转码操作完成或达到失败状态时,让服务调用
如果超时期限已到,系统会调用服务的
Service.onTimeout(int, int)方法。此时,该服务有几秒钟的时间来调用Service.stopSelf()。如果服务未调用Service.stopSelf(),则会发生 ANR,并显示以下错误消息:“<fgs_type> 的前台服务未在超时时间内停止:<component_name>”。注意:
Service.onTimeout(int, int)不适用于 Android 14 或更低版本。在搭载这些版本的设备上,如果媒体处理服务达到超时期限,系统会立即缓存应用。因此,您的应用不应等待收到超时通知。相反,它应在适当情况下尽快终止前台服务或将其更改为后台服务。
Projeção de mídia
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTypemediaProjection- Permissão para declarar no manifesto
FOREGROUND_SERVICE_MEDIA_PROJECTION- Constante a ser transmitida para
startForeground() FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION- Pré-requisitos do ambiente de execução
Chame o método
createScreenCaptureIntent()antes de iniciar o serviço em primeiro plano. Isso mostra uma notificação de permissão ao usuário, que precisa conceder a permissão antes de criar o serviço.Depois de criar o serviço em primeiro plano, chame
MediaProjectionManager.getMediaProjection().- Descrição
Projete o conteúdo em uma tela secundária ou um dispositivo externo usando as APIs
MediaProjection. Esse conteúdo não precisa ser exclusivamente de mídia.- Alternativas
Para fazer streaming de mídia para outro dispositivo, use o SDK do Google Cast.
Microfone
- 在清单中声明的前台服务类型
android:foregroundServiceTypemicrophone- 要在清单中声明的权限
FOREGROUND_SERVICE_MICROPHONE- 要传递给
startForeground()的常量 FOREGROUND_SERVICE_TYPE_MICROPHONE- 运行时前提条件
请求并获得
RECORD_AUDIO运行时权限。- 说明
在后台继续捕获麦克风内容,例如录音器或通信应用。
Ligação telefônica
- 在清单中声明的前台服务类型
android:foregroundServiceTypephoneCall- 要在清单中声明的权限
FOREGROUND_SERVICE_PHONE_CALL- 要传递给
startForeground()的常量 FOREGROUND_SERVICE_TYPE_PHONE_CALL- 运行时前提条件
必须至少满足以下其中一个条件:
- 应用已在其清单文件中声明
MANAGE_OWN_CALLS权限。
- 应用已在其清单文件中声明
- 应用通过
ROLE_DIALER角色成为默认拨号器应用。
- 应用通过
- 说明
使用
ConnectionServiceAPI 继续当前通话。- 替代方案
如果您需要拨打电话、进行视频通话或 VoIP 通话,请考虑使用
android.telecom库。考虑使用
CallScreeningService过滤来电。
Mensagens remotas
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTyperemoteMessaging- Permissão a ser declarada no manifesto
FOREGROUND_SERVICE_REMOTE_MESSAGING- Constante para transmitir para
startForeground() FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING- Pré-requisitos do ambiente de execução
- Nenhum
- Descrição
- Transferir mensagens de texto de um dispositivo para outro. Ajuda na continuidade das tarefas de mensagens de um usuário ao trocar de dispositivo.
Serviço curto
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTypeshortService- Permissão a ser declarada no manifesto
- Nenhum
- Constante para transmitir para
startForeground() FOREGROUND_SERVICE_TYPE_SHORT_SERVICE- Pré-requisitos do ambiente de execução
- Nenhum
- Descrição
Conclua rapidamente trabalhos essenciais que não podem ser interrompidos ou adiados.
Esse tipo tem algumas características únicas:
- Pode ser executado por um curto período de tempo (cerca de três minutos).
- Não oferece suporte a serviços fixos em primeiro plano.
- Não inicia outros serviços em primeiro plano.
- Não requer uma permissão específica do tipo, embora ainda
exija a permissão
FOREGROUND_SERVICE. - Um
shortServicesó pode mudar para outro tipo de serviço se o app estiver qualificado para iniciar um novo serviço em primeiro plano. - Um serviço em primeiro plano pode mudar o tipo para
shortServicea qualquer momento. Nesse ponto, o período de tempo limite começa.
O tempo limite de shortService começa no momento em que
Service.startForeground()é chamado. O app precisa chamarService.stopSelf()ouService.stopForeground()antes que o tempo limite seja atingido. Caso contrário, o novoService.onTimeout()será chamado, dando aos apps a oportunidade de chamarstopSelf()oustopForeground()para interromper o serviço.Pouco depois que
Service.onTimeout()é chamado, o app entra em um estado em cache e não é mais considerado em primeiro plano, a menos que o usuário esteja interagindo ativamente com ele. Se o app entra nesse estado e o serviço não é interrompido, o app recebe um erro ANR. A mensagem ANR mencionaFOREGROUND_SERVICE_TYPE_SHORT_SERVICE. Por esses motivos, uma prática recomendada é implementar o callbackService.onTimeout().O callback
Service.onTimeout()não existe no Android 13 e nas versões anteriores. Se o mesmo serviço for executado nesses dispositivos, ele não receberá um tempo limite nem um erro ANR. Confira se o serviço é interrompido assim que a tarefa de processamento é terminada, mesmo que ele ainda não tenha recebido o callbackService.onTimeout().É importante observar que, se o tempo limite do
shortServicenão for respeitado, o app receberá um erro ANR mesmo que tenha outros serviços em primeiro plano válidos ou outros processos de ciclo de vida em execução.Se um app estiver visível para o usuário ou atender a uma das isenções que permitem que serviços em primeiro plano sejam iniciados em segundo plano, chame
Service.StartForeground()novamente com o parâmetroFOREGROUND_SERVICE_TYPE_SHORT_SERVICE, que estende o tempo limite em mais três minutos. Se o app não estiver visível para o usuário e não atender a uma das isenções, qualquer tentativa de iniciar outro serviço em primeiro plano, independente do tipo, vai causar umaForegroundServiceStartNotAllowedException.Se um usuário desativar a otimização da bateria para seu app, ele ainda será afetado pelo tempo limite do shortService FGS.
Se você iniciar um serviço em primeiro plano que inclua o tipo
shortServicee outro tipo de serviço em primeiro plano, o sistema vai ignorar a declaração do tiposhortService. No entanto, o serviço ainda precisa aderir aos pré-requisitos dos outros tipos declarados. Para mais informações, consulte a documentação de serviços em primeiro plano.
Uso especial
- Tipo de serviço em primeiro plano a ser declarado no manifesto em
android:foregroundServiceTypespecialUse- Permissão a ser declarada no manifesto
FOREGROUND_SERVICE_SPECIAL_USE- Constante para transmitir para
startForeground() FOREGROUND_SERVICE_TYPE_SPECIAL_USE- Pré-requisitos do ambiente de execução
- Nenhum
- Descrição
Abrange todos os casos de uso de serviço em primeiro plano válidos que não são abrangidos por outros tipos de serviço em primeiro plano.
Além de declarar o tipo de serviço em primeiro plano
FOREGROUND_SERVICE_TYPE_SPECIAL_USE, os desenvolvedores precisam declarar casos de uso no manifesto. Para fazer isso, especifique o elemento<property>no elemento<service>. Esses valores e os casos de uso correspondentes são analisados quando você envia o app no Google Play Console. Os casos de uso fornecidos são livres, e você precisa fornecer informações suficientes para que o revisor entenda por que você precisa usar o tipospecialUse.<service android:name="fooService" android:foregroundServiceType="specialUse"> <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE" android:value="explanation_for_special_use"/> </service>
Sistema isento
- Tipo de serviço em primeiro plano a ser declarado no manifesto
android:foregroundServiceTypesystemExempted- Permissão a ser declarada no manifesto
FOREGROUND_SERVICE_SYSTEM_EXEMPTED- Constante a ser transmitida para
startForeground() FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED- Pré-requisitos de tempo de execução
- Nenhum
- Descrição
Reservado para que aplicativos do sistema e integrações específicas do sistema possam continuar usando serviços em primeiro plano.
Para usar esse tipo, um app precisa atender a pelo menos um destes critérios:
- O dispositivo está no modo de demonstração
- O app é proprietário do dispositivo
- O app é proprietário do perfil
- Apps de segurança que têm o papel
ROLE_EMERGENCY - Apps do administrador do dispositivo
- Apps com a permissão
SCHEDULE_EXACT_ALARMouUSE_EXACT_ALARM Apps de VPN (configurados em Configurações > Rede e Internet > VPN)
Caso contrário, a declaração desse tipo faz com que o sistema gere uma
ForegroundServiceTypeNotAllowedException.
Aplicação da política do Google Play para uso de tipos de serviço em primeiro plano
Se o app for direcionado ao Android 14 ou versões mais recentes, será necessário declarar os tipos de serviço em primeiro plano na página "Conteúdo do app" do Play Console (Política > Conteúdo do app). Para mais informações sobre como declarar seus tipos de serviço em primeiro plano no Play Console, consulte Saiba mais sobre o serviço em primeiro plano e os requisitos de intent para tela cheia.