Android 14(API レベル 34)以降では、フォアグラウンド サービスごとに適切なサービス タイプを申告する必要があります。つまり、アプリ マニフェストでサービスタイプを宣言し、そのタイプに適したフォアグラウンド サービス権限をリクエストする必要があります(FOREGROUND_SERVICE
権限をリクエストするほかに)。また、フォアグラウンド サービスのタイプによっては、サービスを起動する前に実行時の権限をリクエストしなければならない場合があります。
カメラ
- マニフェストの
android:foregroundServiceType
で宣言するフォアグラウンド サービスのタイプ camera
- マニフェストで宣言する権限
FOREGROUND_SERVICE_CAMERA
startForeground()
に渡す定数FOREGROUND_SERVICE_TYPE_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 scan API の使用を検討してください。
データの同期
- マニフェストで宣言するフォアグラウンド サービス タイプ
android:foregroundServiceType
dataSync
- マニフェストで宣言する権限
FOREGROUND_SERVICE_DATA_SYNC
startForeground()
に渡す定数FOREGROUND_SERVICE_TYPE_DATA_SYNC
- ランタイムの前提条件
- なし
- 説明
次のようなデータ転送オペレーション:
- データのアップロードまたはダウンロード
- バックアップと復元オペレーション
- インポート / エクスポート オペレーション
- データの取得
- ローカル ファイルの処理
- ネットワーク経由でのデバイスとクラウド間のデータ転送
- 代替
詳細については、データ同期フォアグラウンド サービスの代替手段をご覧ください。
健康
- マニフェストで宣言するフォアグラウンド サービス タイプ
android:foregroundServiceType
health
- マニフェストで宣言する権限
FOREGROUND_SERVICE_HEALTH
startForeground()
に渡す定数FOREGROUND_SERVICE_TYPE_HEALTH
- ランタイムの前提条件
次の条件の少なくとも 1 つを満たす必要があります。
マニフェストで
HIGH_SAMPLING_RATE_SENSORS
権限を宣言します。次の実行時の権限を少なくとも 1 つリクエストし、付与されていること。
- 説明
フィットネス カテゴリのアプリ(エクササイズ トラッカーなど)をサポートする、長時間にわたるユースケース。
位置情報
- 要在清单中的以下位置声明的前台服务类型
android:foregroundServiceType
location
- 在清单中声明的权限
FOREGROUND_SERVICE_LOCATION
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_LOCATION
- 运行时前提条件
用户必须已启用位置信息服务,并且应用必须至少获得以下一项运行时权限:
- 说明
需要位置信息使用权的长时间运行的用例,例如导航和位置信息分享。
- 替代方案
如果您的应用需要在用户到达特定位置时触发,请考虑改用 Geofence API。
メディア
- マニフェストで宣言するフォアグラウンド サービス タイプ
android:foregroundServiceType
mediaPlayback
- マニフェストで宣言する権限
FOREGROUND_SERVICE_MEDIA_PLAYBACK
startForeground()
に渡す定数FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
- ランタイムの前提条件
- なし
- 説明
音声や動画のバックグラウンド再生を続行します。Android TV でデジタル動画録画(DVR)機能をサポートします。
- 代替
ピクチャー イン ピクチャー動画を表示する場合は、ピクチャー イン ピクチャー モードを使用します。
メディアを処理しています
- 要在其清单中声明的前台服务类型
android:foregroundServiceType
mediaProcessing
- 在清单中声明的权限
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 或更低版本。在运行这些版本的设备上,如果媒体处理服务达到超时期限,系统会立即缓存应用。因此,您的应用不应等待收到超时通知。而是应尽快终止前台服务或将其更改为后台服务。
メディア プロジェクション
- 要在清单中的以下位置声明的前台服务类型
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
の実行時の権限をリクエストして付与される。- 説明
ボイス レコーダーや通信アプリなど、バックグラウンドからマイクのキャプチャを続行します。
電話
- 要在清单中的以下位置声明的前台服务类型
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>
除外されたシステム
- マニフェストで申告するフォアグラウンド サービスのタイプ
android:foregroundServiceType
systemExempted
- マニフェストで宣言する権限
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
startForeground()
に渡す定数FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
- ランタイムの前提条件
- なし
- 説明
フォアグラウンド サービスを引き続き使用するために、システムアプリと特定のシステム統合用に予約されています。
このタイプを使用するには、アプリが次の条件の少なくとも 1 つを満たしている必要があります。
- デバイスがデモモードの状態にある
- アプリがデバイス所有者である
- アプリがプロファイラ所有者である
ROLE_EMERGENCY
のロールを持つ緊急情報アプリである- デバイス管理アプリである
SCHEDULE_EXACT_ALARM
権限またはUSE_EXACT_ALARM
権限を保持しているアプリVPN アプリ([設定] > [ネットワークとインターネット] > [VPN] で設定)
そうしないと、このタイプを宣言したときに
ForegroundServiceTypeNotAllowedException
がスローされます。
フォアグラウンド サービス タイプの使用に対する Google Play ポリシーの適用
Android 14 以降をターゲットとするアプリの場合は、Google Play Console の [アプリのコンテンツ] ページ([ポリシー] > [アプリのコンテンツ])で、アプリのフォアグラウンド サービスのタイプを申告する必要があります。Google Play Console でフォアグラウンド サービスのタイプを申告する方法について詳しくは、フォアグラウンド サービスと全画面インテントの要件についてをご覧ください。