Android 14(API レベル 34)以降では、フォアグラウンド サービスごとに適切なサービスタイプを宣言する必要があります。つまり、FOREGROUND_SERVICE
権限をリクエストするだけでなく、アプリ マニフェストでサービスタイプを宣言し、そのタイプに適したフォアグラウンド サービスの権限をリクエストする必要があります。さらに、フォアグラウンド サービスのタイプによっては、サービスを起動する前に実行時の権限をリクエストする必要があります。
カメラ
android:foregroundServiceType
でマニフェストで宣言するフォアグラウンド サービス タイプcamera
- マニフェストで宣言する権限
FOREGROUND_SERVICE_CAMERA
startForeground()
に渡す定数です。FOREGROUND_SERVICE_TYPE_CAMERA
- ランタイムの前提条件
CAMERA
の実行時の権限をリクエストし、その権限を付与する注:
CAMERA
の実行時の権限には、使用中に対する制限が適用されます。このため、いくつかの例外を除き、アプリがバックグラウンドで実行されている間は、camera
フォアグラウンド サービスを作成できません。詳しくは、使用中権限を必要とするフォアグラウンド サービスの起動に関する制限をご覧ください。- 説明
マルチタスクに対応したビデオチャット アプリなど、引き続きバックグラウンドからカメラにアクセスします。
接続されたデバイス
- マニフェストで宣言するフォアグラウンド サービス タイプ
android:foregroundServiceType
connectedDevice
- マニフェストで宣言する権限
FOREGROUND_SERVICE_CONNECTED_DEVICE
startForeground()
に渡す定数です。FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
- ランタイムの前提条件
次の条件の少なくとも 1 つを満たす必要があります。
マニフェストで次の権限のうち少なくとも 1 つを宣言します。
次の実行時の権限のうち少なくとも 1 つをリクエストし、付与されている。
UsbManager.requestPermission()
を呼び出します。
- 説明
Bluetooth、NFC、IR、USB、またはネットワーク接続を必要とする外部デバイスとの通信。
- 代替
アプリが外部デバイスへの継続的なデータ転送を行う必要がある場合は、代わりにコンパニオン デバイス マネージャーの使用を検討してください。コンパニオン デバイス プレゼンス API を使用すると、コンパニオン デバイスが圏内にある場合でもアプリを実行し続けることができます。
アプリで Bluetooth デバイスをスキャンする必要がある場合は、代わりに Bluetooth スキャン API の使用を検討してください。
データの同期
- 要在清单中声明的前台服务类型
android:foregroundServiceType
dataSync
- 在清单中声明的权限
FOREGROUND_SERVICE_DATA_SYNC
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_DATA_SYNC
- 运行时前提条件
- 无
- 说明
数据传输操作,例如:
- 数据上传或下载
- 备份和恢复操作
- 导入或导出操作
- 获取数据
- 本地文件处理
- 通过网络在设备和云端之间传输数据
- 替代方案
创建用户发起的数据传输作业,让用户启动长时间运行的数据上传或下载任务。
使用 Download Manager API 可以通过 URI 下载数据。
使用
BackupManager
备份或恢复数据。对于其他用例,请考虑使用 WorkManager。
健康
- マニフェストで申告するフォアグラウンド サービスのタイプ
android:foregroundServiceType
health
- マニフェストで宣言する権限
FOREGROUND_SERVICE_HEALTH
startForeground()
に渡す定数FOREGROUND_SERVICE_TYPE_HEALTH
- ランタイムの前提条件
次の条件の少なくとも 1 つを満たす必要があります。
マニフェストで
HIGH_SAMPLING_RATE_SENSORS
権限を宣言します。次の実行時の権限の少なくとも 1 つをリクエストし、付与されている。
注:
BODY_SENSORS
の実行時の権限には、使用中に対する制限が適用されます。このため、いくつかの例外を除き、アプリがバックグラウンドで動作しているときにボディセンサーを使用するhealth
フォアグラウンド サービスを作成することはできません。詳しくは、使用中の権限を必要とするフォアグラウンド サービスの起動に関する制限をご覧ください。- 説明
フィットネス カテゴリのアプリ(エクササイズ トラッカーなど)をサポートする、長時間にわたるユースケース。
位置情報
- 要在清单中声明的前台服务类型
android:foregroundServiceType
location
- 在清单中声明的权限
FOREGROUND_SERVICE_LOCATION
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_LOCATION
- 运行时前提条件
请求并被授予以下至少一项运行时权限:
注意:位置信息运行时权限受使用时限制。因此,当您的应用位于后台时,您无法创建
location
前台服务,但存在一些例外情况。如需了解详情,请参阅与启动需要运行时权限的前台服务相关的限制。- 说明
需要位置信息使用权的长时间运行的用例,例如导航和位置信息分享。
- 替代方案
如果需要在用户到达特定位置时触发您的应用,请考虑改用地理围栏 API。
Media
- 要在清单中声明的前台服务类型
android:foregroundServiceType
mediaPlayback
- 在清单中声明的权限
FOREGROUND_SERVICE_MEDIA_PLAYBACK
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
- 运行时前提条件
- 无
- 说明
- 在后台继续播放音频或视频。在 Android TV 上支持数字视频录制 (DVR) 功能。
- 替代方案
- 如果您展示的是画中画视频,请使用“画中画”模式。
メディア プロジェクション
- 要在清单中声明的前台服务类型
android:foregroundServiceType
mediaProjection
- 在清单中声明的权限
FOREGROUND_SERVICE_MEDIA_PROJECTION
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
- 运行时前提条件
在启动前台服务之前调用
createScreenCaptureIntent()
方法。这样做会向用户显示权限通知;用户必须先授予权限,然后您才能创建服务。创建前台服务后,您可以调用
MediaProjectionManager.getMediaProjection()
。- 说明
使用
MediaProjection
API 将内容投影到非主要显示屏或外部设备。这些内容不必完全是媒体内容。- 替代方案
如需将媒体内容流式传输到其他设备,请使用 Google Cast SDK。
マイク
- 要在清单中声明的前台服务类型
android:foregroundServiceType
microphone
- 在清单中声明的权限
FOREGROUND_SERVICE_MICROPHONE
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_MICROPHONE
- 运行时前提条件
请求并获得
RECORD_AUDIO
运行时权限。注意:
RECORD_AUDIO
运行时权限受使用时限制。因此,当您的应用位于后台时,您无法创建microphone
前台服务,但存在一些例外情况。如需了解详情,请参阅与启动需要运行时权限的前台服务相关的限制。- 说明
在后台继续捕获麦克风内容,例如录音器或通信应用。
電話
- 要在清单中声明的前台服务类型
android:foregroundServiceType
phoneCall
- 在清单中声明的权限
FOREGROUND_SERVICE_PHONE_CALL
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_PHONE_CALL
- 运行时前提条件
必须至少满足以下其中一个条件:
- 应用已在其清单文件中声明
MANAGE_OWN_CALLS
权限。
- 应用已在其清单文件中声明
- 应用是通过
ROLE_DIALER
角色成为默认拨号器应用。
- 应用是通过
- 说明
使用
ConnectionService
API 继续当前通话。- 替代方案
如果您需要拨打电话、视频或 VoIP 通话,请考虑使用
android.telecom
库。建议使用
CallScreeningService
过滤来电。
リモート メッセージ
- 要在其清单中声明的前台服务类型
android:foregroundServiceType
remoteMessaging
- 在清单中声明的权限
FOREGROUND_SERVICE_REMOTE_MESSAGING
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
- 运行时前提条件
- 无
- 说明
- 将短信从一台设备转移到另一台设备。在用户切换设备时,帮助确保用户消息任务的连续性。
ショート サービス
- マニフェストで申告するフォアグラウンド サービスのタイプ
android:foregroundServiceType
shortService
- マニフェストで宣言する権限
- なし
startForeground()
に渡す定数FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
- ランタイムの前提条件
- なし
- 説明
中断や延期ができない重要な作業を迅速に終了します。
このタイプには、以下のような特徴があります。
- 短時間(約 3 分)しか実行できない。
- スティッキー フォアグラウンド サービスをサポートしていない。
- 他のフォアグラウンド サービスを開始できない。
- タイプ固有の権限は不要だが、
FOREGROUND_SERVICE
権限は必要。 - 現在アプリが新しいフォアグラウンド サービスを開始できる場合にのみ、
shortService
を別のサービスタイプに変更できます。 - フォアグラウンド サービスは、いつでもタイプを
shortService
に変更でき、その時点でタイムアウト期間が開始されます。
shortService のタイムアウトは、
Service.startForeground()
が呼び出された時点から始まります。アプリは、タイムアウトが発生する前にService.stopSelf()
またはService.stopForeground()
を呼び出すことが想定されています。それ以外の場合は、新しいService.onTimeout()
が呼び出されます。これにより、アプリは短い期間、stopSelf()
またはstopForeground()
を呼び出してサービスを停止できます。Service.onTimeout()
が呼び出されてからしばらくすると、アプリはキャッシュに保存された状態になり、ユーザーがアプリを操作している場合を除き、フォアグラウンドにないと見なされるようになります。アプリがキャッシュに保存されてからしばらくして、サービスが停止していない場合、アプリで ANR が発生します。ANR メッセージには、FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
と記載されます。このような理由から、Service.onTimeout()
コールバックを実装することをおすすめします。Android 13 以前では
Service.onTimeout()
コールバックは存在しません。このようなデバイスで同じサービスが実行されている場合、タイムアウトも ANR も発生しません。Service.onTimeout()
コールバックを受け取っていなくても、処理タスクが完了したらすぐにサービスが停止するようにしてください。shortService
のタイムアウトを尊重しない場合、他の有効なフォアグラウンド サービスや、他のアプリ ライフサイクル プロセスが実行されていても、アプリで ANR が発生することに注意してください。アプリがユーザーに表示されている場合、または、バックグラウンドからのフォアグラウンド サービスの開始を許可する除外の条件の一つを満たす場合、もう一度
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
が呼び出され、Service.StartForeground()
のパラメータによってタイムアウトがさらに 3 分延長されます。アプリがユーザーに表示されておらず、除外の条件の一つを満たしていない場合、別のフォアグラウンド サービスを起動しようとすると、タイプに関係なくForegroundServiceStartNotAllowedException
が発生します。ユーザーがアプリのバッテリーの最適化を無効にしていても、shortService FGS のタイムアウトの影響を受けます。
shortService
タイプと別のフォアグラウンド サービス タイプを含むフォアグラウンド サービスを開始する場合、システムはshortService
タイプの宣言を無視します。ただし、サービスは引き続き、他の宣言されたタイプの前提条件に準拠している必要があります。詳細については、フォアグラウンド サービスのドキュメントをご覧ください。
特殊用途
- マニフェストで申告するフォアグラウンド サービスのタイプ
android:foregroundServiceType
specialUse
- マニフェストで宣言する権限
FOREGROUND_SERVICE_SPECIAL_USE
startForeground()
に渡す定数FOREGROUND_SERVICE_TYPE_SPECIAL_USE
- ランタイムの前提条件
- なし
- 説明
他のフォアグラウンド サービス タイプでは対応できない有効なフォアグラウンド サービスのユースケースに対応します。
デベロッパーは、
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
フォアグラウンド サービス タイプを宣言することに加えて、マニフェストでユースケースを宣言する必要があります。そのためには、<service>
要素内に<property>
要素を指定します。これらの値とそれに対応するユースケースは、Google Play Console でアプリを送信する際に審査されます。提示するユースケースは自由形式であるため、specialUse
タイプを使用する理由をレビュアーが確認できるように、十分な情報を提供してください。<service android:name="fooService" android:foregroundServiceType="specialUse"> <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE" android:value="explanation_for_special_use"/> </service>
除外されたシステム
- Foreground service type to declare in manifest under
android:foregroundServiceType
systemExempted
- Permission to declare in your manifest
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
- Runtime prerequisites
- None
- Description
Reserved for system applications and specific system integrations, to continue to use foreground services.
To use this type, an app must meet at least one of the following criteria:
- Device is in demo mode state
- App is a Device Owner
- App is a Profiler Owner
- Safety Apps that have the
ROLE_EMERGENCY
role - Device Admin apps
- Apps holding
SCHEDULE_EXACT_ALARM
orUSE_EXACT_ALARM
permission VPN apps (configured using Settings > Network & Internet > VPN)
Otherwise, declaring this type causes the system to throw a
ForegroundServiceTypeNotAllowedException
.
フォアグラウンド サービス タイプの使用に対する Google Play ポリシーの適用
如果您的应用以 Android 14 或更高版本为目标平台,您需要在 Play 管理中心的应用内容页面(政策 > 应用内容)中声明应用的前台服务类型。如需详细了解如何在 Play 管理中心内声明前台服务类型,请参阅了解前台服务和全屏 intent 要求。