フォアグラウンド サービスのタイプ

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
运行时前提条件

必须至少满足以下其中一个条件：

说明

与需要蓝牙、NFC、IR、USB 或网络连接的外部设备进行互动。

替代方案

如果您的应用需要向外部设备持续传输数据，请考虑改用配套设备管理器。使用配套设备感知 API，可帮助您的应用在配套设备在范围内时保持运行。

如果您的应用需要扫描蓝牙设备，请考虑改用 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
运行时前提条件

必须至少满足以下其中一个条件：

说明

为健身类别的应用（例如锻炼追踪器）提供支持的所有长时间运行的用例。

位置情報

要在清单中的以下位置声明的前台服务类型
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.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
运行时前提条件

必须至少满足以下其中一个条件：

  • 应用通过 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> 元素。这些值和相应的应用场景 。用途 您提供的案例均为自由形式，因此，您应确保提供足够的 相关信息，让审核人员了解您为何需要使用 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 つを満たしている必要があります。

フォアグラウンド サービス タイプの使用に対する Google Play ポリシーの適用

Android 14 以降をターゲットとするアプリの場合は、Google Play Console の [アプリのコンテンツ] ページ（[ポリシー] > [アプリのコンテンツ]）で、アプリのフォアグラウンド サービスのタイプを申告する必要があります。Google Play Console でフォアグラウンド サービスのタイプを申告する方法について詳しくは、フォアグラウンド サービスと全画面インテントの要件についてをご覧ください。