API Android 6.0

Android 6.0 (M) предлагает новые функции для пользователей и разработчиков приложений. В этом документе представлены наиболее важные API.

Сайт для разработчиков

Чтобы начать разработку приложений для Android 6.0, сначала необходимо получить Android SDK. Затем с помощью SDK Manager скачайте платформу Android 6.0 SDK и образы системы.

Обновите целевой уровень API

Чтобы оптимизировать приложение для устройств Android, задайте для параметра targetSdkVersion значение "23", установите приложение на системный образ Android, протестируйте его и опубликуйте обновленную версию.

Вы можете использовать API Android и при этом поддерживать более ранние версии. Для этого добавьте в код условия, которые проверяют уровень API системы перед выполнением API, не поддерживаемых вашим minSdkVersion. Подробнее о том, как обеспечить обратную совместимость…

Подробнее о том, что такое уровень API…

Аутентификация по отпечатку пальца

В этом выпуске представлены новые API, позволяющие выполнять аутентификацию пользователей по отпечаткам пальцев на поддерживаемых устройствах. Используйте эти API в сочетании с системой хранилища ключей Android.

Чтобы аутентифицировать пользователей с помощью сканирования отпечатков пальцев, получите экземпляр нового класса FingerprintManager и вызовите метод authenticate(). Приложение должно быть запущено на совместимом устройстве со сканером отпечатков пальцев. Вам необходимо реализовать пользовательский интерфейс для аутентификации по отпечатку пальца в приложении и использовать стандартный значок отпечатка пальца Android. Значок отпечатка пальца Android (c_fp_40px.png) включен в пример биометрической аутентификации. Если вы разрабатываете несколько приложений, в которых используется аутентификация по отпечатку пальца, помните, что каждое приложение должно выполнять аутентификацию независимо от других.

Чтобы использовать эту функцию в приложении, сначала добавьте разрешение USE_FINGERPRINT в манифест.

<uses-permission
        android:name="android.permission.USE_FINGERPRINT" />
Мобильный телефон с функцией аутентификации по отпечатку пальца

Пример реализации аутентификации по отпечатку пальца в приложении можно посмотреть в образце биометрической аутентификации. Чтобы узнать, как использовать эти API аутентификации в сочетании с другими API Android, посмотрите видео Fingerprint and Payment APIs (API отпечатков пальцев и платежей).

Если вы тестируете эту функцию, выполните следующие действия:

  1. Установите Android SDK Tools версии 24.3, если вы этого ещё не сделали.
  2. Зарегистрируйте новый отпечаток пальца в эмуляторе, выбрав Настройки > Безопасность > Отпечаток пальца, а затем следуйте инструкциям по регистрации.
  3. Используйте эмулятор, чтобы имитировать события касания сканера отпечатков пальцев с помощью следующей команды. Используйте ту же команду, чтобы эмулировать события касания сканера отпечатков пальцев на заблокированном экране или в приложении.
    adb -e emu finger touch <finger_id>
    

    В Windows может потребоваться запустить telnet 127.0.0.1 <emulator-id>, а затем finger touch <finger_id>.

Подтвердите учетные данные

Приложение может аутентифицировать пользователей в зависимости от того, как давно они разблокировали устройство. Благодаря этой функции пользователям не нужно запоминать дополнительные пароли для приложений, а вам – создавать собственный пользовательский интерфейс аутентификации. Для аутентификации пользователей в приложении эта функция должна использоваться вместе с открытым или секретным ключом.

Чтобы задать время, в течение которого один и тот же ключ можно использовать повторно после успешной аутентификации пользователя, вызовите новый метод setUserAuthenticationValidityDurationSeconds() при настройке KeyGenerator или KeyPairGenerator.

Не показывайте диалоговое окно повторной аутентификации слишком часто. Приложения должны сначала попытаться использовать криптографический объект, а если время ожидания истечет, использовать метод createConfirmDeviceCredentialIntent() для повторной аутентификации пользователя в приложении.

Связывание приложений

В этом выпуске улучшена система намерений Android за счет более мощных ссылок на приложения. Эта функция позволяет связать приложение с принадлежащим вам веб-доменом. На основе этой связи платформа может определить, какое приложение по умолчанию использовать для обработки определенной веб-ссылки, и не предлагать пользователям выбрать приложение. Чтобы узнать, как реализовать эту функцию, ознакомьтесь со статьей Обработка ссылок на приложения.

Автоматическое резервное копирование для приложений

Теперь система автоматически выполняет полное резервное копирование и восстановление данных приложений. Чтобы включить эту функцию, приложение должно быть предназначено для Android 6.0 (уровень API 23). Добавлять дополнительный код не нужно. Если пользователи удалят свои аккаунты Google, их резервные копии данных также будут удалены. Чтобы узнать, как работает эта функция и как настроить резервное копирование файловой системы, ознакомьтесь со статьей Настройка автоматического резервного копирования для приложений.

Прямая отправка

Нижняя часть экрана мобильного устройства с функцией прямой отправки

В этом выпуске представлены API, которые делают обмен данными интуитивно понятным и быстрым для пользователей. Теперь вы можете определить цели прямой отправки, которые запускают определенное действие в приложении. Эти цели прямой отправки доступны пользователям в меню Поделиться. Эта функция позволяет пользователям делиться контентом с другими пользователями, например контактами, в других приложениях. Например, цель прямой отправки может запустить действие в другом приложении социальной сети, что позволит пользователю поделиться контентом напрямую с определенным другом или сообществом в этом приложении.

Чтобы включить цели прямой отправки, необходимо определить класс, расширяющий класс ChooserTargetService. Объявите службу в манифесте. В этой декларации укажите разрешение BIND_CHOOSER_TARGET_SERVICE и фильтр интентов, используя действие SERVICE_INTERFACE.

В примере ниже показано, как объявить ChooserTargetService в манифесте.

<service android:name=".ChooserTargetService"
        android:label="@string/service_name"
        android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE">
    <intent-filter>
        <action android:name="android.service.chooser.ChooserTargetService" />
    </intent-filter>
</service>

Для каждого действия, которое вы хотите сделать доступным для ChooserTargetService, добавьте элемент <meta-data> с именем "android.service.chooser.chooser_target_service" в манифест приложения.

<activity android:name=".MyShareActivity"
        android:label="@string/share_activity_label">
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
    </intent-filter>
<meta-data
        android:name="android.service.chooser.chooser_target_service"
        android:value=".ChooserTargetService" />
</activity>

Голосовые взаимодействия

В этом выпуске представлен новый API голосового взаимодействия, который вместе с голосовыми командами позволяет добавлять в приложения голосовые функции. Вызовите метод isVoiceInteraction(), чтобы определить, было ли действие запущено голосовой командой. Если да, то ваше приложение может использовать класс VoiceInteractor, чтобы запрашивать у пользователя голосовое подтверждение, выбирать из списка вариантов и выполнять другие действия.

Большинство голосовых взаимодействий начинается с голосовой команды пользователя. Однако голосовое взаимодействие может начаться и без участия пользователя. Например, другое приложение, запущенное с помощью голосового взаимодействия, также может отправить намерение запустить голосовое взаимодействие. Чтобы определить, было ли действие запущено голосовым запросом пользователя или другим приложением для голосового взаимодействия, вызовите метод isVoiceInteractionRoot(). Если объект activity был запущен другим приложением, метод возвращает false. После этого приложение может попросить пользователя подтвердить, что он действительно хотел выполнить это действие.

Подробную информацию о реализации голосовых команд можно найти на сайте для разработчиков.

Assist API

В этом выпуске пользователям предлагается новый способ взаимодействия с вашими приложениями через Ассистента. Чтобы использовать эту функцию, пользователь должен разрешить Ассистенту использовать текущий контекст. После этого пользователь сможет вызвать Ассистента из любого приложения, нажав и удерживая кнопку Главный экран.

Вы можете запретить приложению передавать текущий контекст Ассистенту, установив флаг FLAG_SECURE. Помимо стандартного набора информации, который платформа передает Ассистенту, ваше приложение может передавать дополнительные данные с помощью нового класса AssistContent.

Чтобы предоставить помощнику дополнительный контекст из приложения, выполните следующие действия:

  1. Реализуйте интерфейс Application.OnProvideAssistDataListener.
  2. Зарегистрируйте этот прослушиватель с помощью registerOnProvideAssistDataListener().
  3. Чтобы предоставить контекстную информацию о действиях, переопределите обратный вызов onProvideAssistData() и, при необходимости, новый обратный вызов onProvideAssistContent().

Внедряемые накопители

В этой версии пользователи могут адаптировать внешние устройства хранения данных, например SD-карты. Принятие внешнего накопителя шифрует и форматирует устройство, чтобы оно работало как внутренняя память. Эта функция позволяет пользователям перемещать приложения и их личные данные между накопителями. При переносе приложений система учитывает параметр android:installLocation в манифесте.

Если ваше приложение обращается к перечисленным ниже API или полям, имейте в виду, что возвращаемые ими пути к файлам будут динамически меняться при перемещении приложения между внутренним и внешним накопителями. При создании путей к файлам настоятельно рекомендуется всегда вызывать эти API динамически. Не используйте жестко заданные пути к файлам и не сохраняйте полные пути, созданные ранее.

Чтобы отладить эту функцию, вы можете включить адаптацию USB-накопителя, подключенного к устройству Android через кабель USB On-The-Go (OTG), выполнив следующую команду:

$ adb shell sm set-force-adoptable true

Уведомления

В этом выпуске в API добавлены следующие изменения, связанные с уведомлениями:

  • Новый уровень фильтра INTERRUPTION_FILTER_ALARMS, который соответствует новому режиму "Не беспокоить" Только будильники.
  • Новое значение категории CATEGORY_REMINDER, которое используется, чтобы отличать напоминания, запланированные пользователем, от других событий (CATEGORY_EVENT) и будильников (CATEGORY_ALARM).
  • Новый класс Icon, который можно прикрепить к уведомлениям с помощью методов setSmallIcon() и setLargeIcon(). Аналогично метод addAction() теперь принимает объект Icon вместо идентификатора прорисовываемого ресурса.
  • Новый метод getActiveNotifications(), который позволяет приложениям узнавать, какие из их уведомлений сейчас активны.

Поддержка стилуса Bluetooth

В этом выпуске улучшена поддержка ввода с помощью стилуса Bluetooth. Пользователи могут подключать совместимые стилусы Bluetooth к телефонам и планшетам. При подключении информация о положении стилуса на сенсорном экране объединяется с данными о силе нажатия и кнопках, что позволяет расширить возможности ввода. Приложение может отслеживать нажатия кнопок стилуса и выполнять дополнительные действия, регистрируя объекты View.OnContextClickListener и GestureDetector.OnContextClickListener в действии.

Используйте методы и константы MotionEvent, чтобы обнаруживать нажатия кнопок стилуса:

  • Если пользователь касается стилусом с кнопкой экрана вашего приложения, метод getTooltype() возвращает TOOL_TYPE_STYLUS.
  • В приложениях для Android 6.0 (уровень API 23) метод getButtonState() возвращает значение BUTTON_STYLUS_PRIMARY, когда пользователь нажимает основную кнопку стилуса. Если у стилуса есть вторая кнопка, то при ее нажатии тот же метод возвращает BUTTON_STYLUS_SECONDARY. Если пользователь нажимает обе кнопки одновременно, метод возвращает оба значения, объединенные оператором ИЛИ (BUTTON_STYLUS_PRIMARY|BUTTON_STYLUS_SECONDARY).
  • Для приложений, предназначенных для более ранних версий платформы, метод getButtonState() возвращает BUTTON_SECONDARY (для нажатия основной кнопки стилуса), BUTTON_TERTIARY (для нажатия дополнительной кнопки стилуса) или оба значения.

Улучшенное сканирование Bluetooth с низким энергопотреблением

Если ваше приложение выполняет сканирование Bluetooth с низким энергопотреблением, используйте новый метод setCallbackType(), чтобы указать, что система должна уведомлять обратные вызовы, когда она впервые находит или видит после долгого времени пакет объявления, соответствующий набору ScanFilter. Этот подход к сканированию более энергоэффективен, чем в предыдущей версии платформы.

Поддержка Hotspot 2.0 Release 1

В этом выпуске добавлена поддержка спецификации Hotspot 2.0 Release 1 на устройствах Nexus 6 и Nexus 9. Чтобы предоставить учетные данные Hotspot 2.0 в приложении, используйте новые методы класса WifiEnterpriseConfig, например setPlmn() и setRealm(). В объекте WifiConfiguration можно задать поля FQDN и providerFriendlyName. Новый метод isPasspointNetwork() указывает, является ли обнаруженная сеть точкой доступа Hotspot 2.0.

Режим отображения 4K

Теперь приложения могут запрашивать повышение разрешения экрана до 4K на совместимом оборудовании. Чтобы запросить текущее физическое разрешение, используйте новые API Display.Mode. Если интерфейс отрисовывается с более низким логическим разрешением и масштабируется до более высокого физического разрешения, помните, что физическое разрешение, возвращаемое методом getPhysicalWidth(), может отличаться от логического разрешения, возвращаемого методом getSize().

Вы можете запросить у системы изменение физического разрешения в приложении во время его работы, задав свойство preferredDisplayModeId окна приложения. Эта функция полезна, если вы хотите переключиться на разрешение 4K. В режиме 4K интерфейс по-прежнему отображается в исходном разрешении (например, 1080p) и масштабируется до 4K, но объекты SurfaceView могут показывать контент в исходном разрешении.

ColorStateList с поддержкой тем

Атрибуты темы теперь поддерживаются в ColorStateList для устройств с Android 6.0 (уровень API 23). Методы Resources.getColorStateList() и Resources.getColor() больше не поддерживаются. Если вы вызываете эти API, вместо них вызывайте новые методы Context.getColorStateList() или Context.getColor(). Эти методы также доступны в библиотеке v4 appcompat с помощью ContextCompat.

Функции аудио

В этом выпуске улучшена обработка аудио на Android, в том числе:

  • Поддержка протокола MIDI с новыми API android.media.midi. Используйте эти API для отправки и получения MIDI-событий.
  • Новые классы AudioRecord.Builder и AudioTrack.Builder для создания объектов цифровой аудиозаписи и воспроизведения соответственно, а также настройки свойств источника и приемника звука для переопределения системных настроек по умолчанию.
  • API-хуки для связывания аудиоустройств и устройств ввода. Это особенно полезно, если ваше приложение позволяет пользователям запускать голосовой поиск с игрового контроллера или пульта дистанционного управления, подключенного к Android TV. Когда пользователь начинает поиск, система вызывает новый обратный вызов onSearchRequested(). Чтобы определить, есть ли у устройства ввода пользователя встроенный микрофон, получите объект InputDevice из этого обратного вызова, а затем вызовите новый метод hasMicrophone().
  • Новый метод getDevices(), который позволяет получить список всех аудиоустройств, подключенных к системе. Вы также можете зарегистрировать объект AudioDeviceCallback, чтобы система уведомляла ваше приложение о подключении или отключении аудиоустройства.

Функции для съемки и обработки видео

В этом выпуске в API обработки видео добавлены новые возможности, в том числе:

  • Новый класс MediaSync, который помогает приложениям синхронно воспроизводить аудио- и видеопотоки. Аудиобуферы отправляются в неблокирующем режиме и возвращаются с помощью обратного вызова. Также поддерживается динамическая скорость воспроизведения.
  • Новое событие EVENT_SESSION_RECLAIMED, которое указывает, что сеанс, открытый приложением, был восстановлен диспетчером ресурсов. Если в вашем приложении используются сеансы DRM, вы должны обрабатывать это событие и не использовать возвращенный сеанс.
  • Новый код ошибки ERROR_RECLAIMED, который указывает, что диспетчер ресурсов вернул медиаресурс, используемый кодеком. В этом случае кодек должен быть освобожден, так как он перешел в конечное состояние.
  • Новый интерфейс getMaxSupportedInstances(), позволяющий получить подсказку о максимальном количестве поддерживаемых параллельных экземпляров кодека.
  • Новый метод setPlaybackParams() для настройки скорости воспроизведения медиаконтента. При этом аудиодорожка автоматически растягивается или ускоряется вместе с видео.

Функции камеры

В этом выпуске добавлены новые API для доступа к фонарику камеры и для повторной обработки изображений камерой:

Flashlight API

Если у камеры есть вспышка, вы можете вызвать метод setTorchMode(), чтобы включить или выключить режим фонарика, не открывая камеру. Приложение не имеет эксклюзивного права собственности на вспышку или камеру. Режим фонарика отключается и становится недоступным, когда камера или другие ресурсы, необходимые для работы фонарика, становятся недоступными. Другие приложения также могут вызывать метод setTorchMode(), чтобы выключить фонарик. Когда последнее приложение, которое включило режим фонарика, закрывается, режим фонарика отключается.

Вы можете зарегистрировать обратный вызов, чтобы получать уведомления о статусе режима фонарика, вызвав метод registerTorchCallback(). При первой регистрации обратного вызова он немедленно вызывается со статусом режима фонарика для всех известных на данный момент камер со вспышкой. Если режим фонарика включен или выключен успешно, вызывается метод onTorchModeChanged().

Reprocessing API

API Camera2 расширен для поддержки повторной обработки изображений в формате YUV и частном непрозрачном формате. Чтобы узнать, доступны ли эти возможности повторной обработки, вызовите getCameraCharacteristics() и проверьте ключ REPROCESS_MAX_CAPTURE_STALL. Если устройство поддерживает повторную обработку, вы можете создать сеанс съемки с поддержкой повторной обработки, вызвав метод createReprocessableCaptureSession(), и создать запросы на повторную обработку входного буфера.

Используйте класс ImageWriter, чтобы подключить поток входного буфера к входу повторной обработки камеры. Чтобы получить пустой буфер, используйте следующую модель программирования:

  1. Вызовите метод dequeueInputImage().
  2. Заполните буфер ввода данными.
  3. Отправьте буфер в камеру, вызвав метод queueInputImage().

Если вы используете объект ImageWriter вместе с изображением PRIVATE, ваше приложение не сможет получить доступ к данным изображения напрямую. Вместо этого передайте изображение PRIVATE напрямую в ImageWriter, вызвав метод queueInputImage() без копирования буфера.

Класс ImageReader теперь поддерживает потоки изображений в формате PRIVATE. Это позволяет приложению поддерживать циклическую очередь из ImageReader выходных изображений, выбирать одно или несколько из них и отправлять их в ImageWriter для повторной обработки.

Функции Android for Work

В этом выпуске добавлены следующие новые API для Android for Work:

  • Расширенные возможности управления корпоративными устройствами одноразового использования. Владелец устройства теперь может управлять следующими настройками:
    • Отключите или повторно включите блокировку экрана с помощью метода setKeyguardDisabled().
    • Отключить или снова включить строку состояния (в том числе быстрые настройки, уведомления и жест навигации, запускающий Google Now) можно с помощью метода setStatusBarDisabled().
    • Отключите или повторно включите безопасную загрузку с помощью константы UserManager. DISALLOW_SAFE_BOOT
    • Запретите отключение экрана при подключении к сети с помощью константы STAY_ON_WHILE_PLUGGED_IN.
  • Автоматическая установка и удаление приложений владельцем устройства. Теперь владелец устройства может автоматически устанавливать и удалять приложения с помощью API PackageInstaller независимо от Google Play for Work. Теперь вы можете инициализировать устройства через владельца устройства, который получает и устанавливает приложения без участия пользователя. Эта функция позволяет в одно касание настраивать киоски и другие подобные устройства без активации аккаунта Google.
  • Доступ к корпоративному сертификату без уведомления. Когда приложение вызывает метод choosePrivateKeyAlias(), прежде чем пользователю будет предложено выбрать сертификат, владелец профиля или устройства может вызвать метод onChoosePrivateKeyAlias(), чтобы предоставить псевдоним запрашивающему приложению без уведомления. Эта функция позволяет предоставлять управляемым приложениям доступ к сертификатам без участия пользователя.
  • Автоматическое принятие обновлений системы. Задав правила обновления системы с помощью setSystemUpdatePolicy(), владелец устройства может разрешить автоматическое принятие обновлений (например, для киосков) или отложить их установку на срок до 30 дней. Кроме того, администратор может задать ежедневное временное окно, в течение которого должно быть выполнено обновление, например в часы, когда устройство в режиме киоска не используется. Когда обновление системы становится доступным, система проверяет, заданы ли правила обновления в приложении контроллера политик на устройствах, и действует в соответствии с ними.
  • Делегированная установка сертификатов. Владелец профиля или устройства теперь может предоставить стороннему приложению возможность вызывать следующие DevicePolicyManager API для управления сертификатами:
  • Мобильный телефон, на экране которого показано уведомление о статусе рабочего профиля в Android for Work
  • Отслеживание использования данных. Владелец профиля или устройства теперь может запрашивать статистику использования данных, которая отображается в разделе Настройки > Использование данных, с помощью новых методов NetworkStatsManager. Владельцы профилей автоматически получают разрешение на запрос данных в управляемом профиле, а владельцы устройств – доступ к данным об использовании основного управляемого пользователя.
  • Управление динамическими разрешениями

    Владелец профиля или устройства может задать Permissions Policy для всех динамических запросов от всех приложений с помощью setPermissionPolicy(). При этом пользователь может получать запрос на предоставление разрешения, или же разрешение может предоставляться или отклоняться автоматически. Если задано второе правило, пользователь не сможет изменить выбор, сделанный владельцем профиля или устройства, на экране разрешений приложения в Настройках.

  • VPN в настройках. VPN-приложения теперь можно найти в разделе Настройки > Ещё > VPN. Кроме того, уведомления, которые сопровождают использование VPN, теперь зависят от того, как настроена эта сеть. Для владельца профиля уведомления зависят от того, настроена ли VPN для управляемого профиля, личного профиля или обоих. Для владельца устройства уведомления зависят от того, настроена ли сеть VPN для всего устройства.
  • Уведомление о рабочем статусе. В строке состояния появляется значок портфеля, когда приложение из управляемого профиля активно. Кроме того, если устройство разблокируется непосредственно в приложении управляемого профиля, пользователь увидит всплывающее уведомление о том, что он находится в рабочем профиле.