Объявите службы переднего плана и запросите разрешения

В манифесте приложения объявите каждую из служб переднего плана с помощью элемента <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 . Если к вашему сервису применимо несколько типов, разделите их оператором | . Например, если ваш сервис использует камеру и микрофон, объявите их следующим образом:

  android:foregroundServiceType="camera|microphone"
  

• В зависимости от того, на какой уровень API ориентировано ваше приложение, вам может потребоваться объявить службы переднего плана в манифесте приложения. Требования для конкретных уровней API описаны в разделе «Изменения в службах переднего плана» .

  Если вы попытаетесь создать службу переднего плана, а ее тип не объявлен в манифесте, система выдаст исключение MissingForegroundServiceTypeException при вызове startForeground() .

  Даже если это не требуется, рекомендуется объявить все приоритетные службы и указать их типы служб.

Запросить разрешения на работу службы переднего плана

В следующем коде показано, как запросить разрешения для службы переднего плана, использующей камеру.

<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 или выше.

В манифесте приложения объявите каждую из служб переднего плана с помощью элемента <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 . Если к вашему сервису применимо несколько типов, разделите их оператором | . Например, если ваш сервис использует камеру и микрофон, объявите их следующим образом:

  android:foregroundServiceType="camera|microphone"
  

• В зависимости от того, на какой уровень API ориентировано ваше приложение, вам может потребоваться объявить службы переднего плана в манифесте приложения. Требования для конкретных уровней API описаны в разделе «Изменения в службах переднего плана» .

  Если вы попытаетесь создать службу переднего плана, а ее тип не объявлен в манифесте, система выдаст исключение MissingForegroundServiceTypeException при вызове startForeground() .

  Даже если это не требуется, рекомендуется объявить все приоритетные службы и указать их типы служб.

Запросить разрешения на работу службы переднего плана

В следующем коде показано, как запросить разрешения для службы переднего плана, использующей камеру.

<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 или выше.