フォアグラウンド サービスを宣言して権限をリクエストする

アプリのマニフェストで、アプリの各フォアグラウンド サービスを <service> 要素で宣言します。各サービスで、android:foregroundServiceType 属性を使用して、サービスがどのような処理を行うかを宣言します。

また、フォアグラウンド サービスに必要な権限をリクエストします。

バージョンの互換性

フォアグラウンド サービスの宣言と権限のリクエストの要件は、アプリのターゲット API レベルによって異なります。このページでは、API レベル 34 以降をターゲットとするアプリの要件について説明します。以前のプラットフォーム バージョンのフォアグラウンド サービスの変更については、フォアグラウンド サービスの変更をご覧ください。

アプリ マニフェストでフォアグラウンド サービスを宣言する

次のコードは、メディア再生フォアグラウンド サービスを宣言する方法を示しています。このようなサービスを使用して音楽を再生できます。

<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...>
  <application ...>

    <service
        android:name=".MyMediaPlaybackService"
        android:foregroundServiceType="mediaPlayback"
        android:exported="false">
    </service>
  </application>
</manifest>

コードに関する主なポイント

• この例では、サービスには media というタイプが 1 つだけあります。サービスに複数のタイプが該当する場合は、| 演算子で区切ります。たとえば、サービスがカメラとマイクを使用する場合は、次のように宣言します。

  android:foregroundServiceType="camera|microphone"
  

• アプリのターゲット API レベルによっては、アプリ マニフェストでフォアグラウンド サービスを宣言することが義務付けられる場合があります。特定の API レベルの要件については、フォアグラウンド サービスの変更をご覧ください。

  フォアグラウンド サービスを作成しようとして、そのタイプがマニフェストで宣言されていない場合、startForeground() を呼び出すとシステムは MissingForegroundServiceTypeException をスローします。

  必須ではない場合でも、すべてのフォアグラウンド サービスを宣言し、そのサービスタイプを指定することをおすすめします。

フォアグラウンド サービスの権限をリクエストする

次のコードは、カメラを使用するフォアグラウンド サービスに対する権限をリクエストする方法を示しています。

<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...>

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CAMERA"/>

    <application ...>
        ...
    </application>
</manifest>

コードに関する主なポイント

• このコードは、API レベル 34 以降をターゲットとするアプリのベスト プラクティスを使用しています。