API Android 4.4

Уровень API: 19

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

Разработчикам приложений рекомендуется как можно скорее скачать образ системы Android 4.4 и платформу SDK из SDK Manager. Если у вас нет устройства с Android 4.4, используйте образ системы Android 4.4, чтобы протестировать приложение в эмуляторе Android. Затем создайте приложения для платформы Android 4.4, чтобы начать использовать последние API.

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

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

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

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

Важные изменения в работе

Если вы уже публиковали приложение для Android, учтите, что изменения в Android 4.4 могут повлиять на его работу.

Если приложение считывает данные из внешнего хранилища…

Приложение не может читать общие файлы на внешнем накопителе в Android 4.4, если у него нет разрешения READ_EXTERNAL_STORAGE. Это означает, что файлы в каталоге, возвращенном getExternalStoragePublicDirectory(), больше не доступны без разрешения. Однако если вам нужен доступ только к каталогам, которые относятся к вашему приложению и предоставляются методом getExternalFilesDir(), то разрешение READ_EXTERNAL_STORAGE не требуется.

Если в вашем приложении используется WebView

Приложение может работать иначе на устройствах с Android 4.4, особенно если вы обновите targetSdkVersion до версии 19 или выше.

Код, лежащий в основе класса WebView и связанных API, был обновлен и теперь основан на современной версии исходного кода Chromium. Это улучшает производительность, добавляет поддержку новых функций HTML5 и удаленной отладки контента WebView. Если в вашем приложении используется WebView, то в некоторых случаях его работа может измениться. Известные изменения в поведении задокументированы и в основном влияют на приложение, только если вы обновите его targetSdkVersion до версии 19 или выше. Новый WebView работает в режиме совместимости, чтобы обеспечить некоторые устаревшие функции в приложениях, предназначенных для целевого уровня API 18 и ниже. Однако возможно, что ваше приложение зависит от неизвестных поведений предыдущей версии WebView.

Если в вашем приложении используется WebView, как можно скорее протестируйте его на Android 4.4 и прочитайте статью Переход на WebView в Android 4.4. В ней рассказывается, как на приложение может повлиять обновление targetSdkVersion до версии 19 или более поздней.

Если в вашем приложении используется AlarmManager…

Если в приложении для параметра targetSdkVersion задано значение 19 или выше, будильники, созданные с помощью set() или setRepeating(), будут неточными.

Чтобы повысить энергоэффективность, Android теперь объединяет в пакеты сигналы от всех приложений, которые происходят в разумно схожее время, чтобы система выводила устройство из спящего режима один раз, а не несколько раз для обработки каждого сигнала.

Если запланированная операция не связана с точным временем, но важно, чтобы она сработала в определенный интервал времени (например, между 14:00 и 16:00), вы можете использовать новый метод setWindow(). Он принимает самое раннее время для запланированной операции и окно времени после него, в течение которого система должна вызвать запланированную операцию.

Если будильник должен быть привязан к точному времени (например, для напоминания о мероприятии в календаре), вы можете использовать новый метод setExact().

Это поведение неточного пакетного режима применяется только к обновленным приложениям. Если вы установили для targetSdkVersion значение 18 или ниже, то на устройствах с Android 4.4 будильники будут работать так же, как и в предыдущих версиях.

Если ваше приложение синхронизирует данные с помощью ContentResolver…

Если для параметра targetSdkVersion задано значение 19 или выше, то при создании синхронизации с addPeriodicSync() операции синхронизации будут выполняться в пределах гибкого интервала по умолчанию, составляющего примерно 4 % от указанного вами периода. Например, если частота опроса составляет 24 часа, то синхронизация может происходить в течение примерно одного часа каждый день, а не в одно и то же время.

Чтобы задать собственный гибкий интервал для операций синхронизации, используйте новый метод requestSync(). Подробнее об адаптерах синхронизации…

Такое поведение гибкого интервала применяется только к обновленным приложениям. Если вы установили для targetSdkVersion значение 18 или ниже, существующие запросы на синхронизацию будут выполняться так же, как и в предыдущих версиях, если они запущены на Android 4.4.

Фреймворк печати

В Android теперь есть полноценный фреймворк, который позволяет пользователям печатать любые документы на принтере, подключенном по Wi-Fi, Bluetooth или через другие сервисы. Система обрабатывает транзакцию между приложением, которое хочет напечатать документ, и сервисами, которые доставляют задания печати на принтер. Фреймворк android.print предоставляет все API, необходимые для того, чтобы указать документ и отправить его на печать. Какие API вам понадобятся для конкретного задания печати, зависит от вашего контента.

Печать общего контента

Если вы хотите распечатать контент из интерфейса в виде документа, сначала создайте подкласс PrintDocumentAdapter. В этом классе необходимо реализовать несколько методов обратного вызова, в том числе onLayout(), чтобы создать макет на основе предоставленных свойств печати, и onWrite(), чтобы сериализовать контент для печати в ParcelFileDescriptor.

Чтобы записать контент в ParcelFileDescriptor, необходимо передать его в формате PDF. Новые API PdfDocument предлагают удобный способ сделать это, предоставляя Canvas из getCanvas(), на котором вы можете нарисовать контент для печати. Затем запишите PdfDocument в ParcelFileDescriptor с помощью метода writeTo().

После того как вы определите реализацию для PrintDocumentAdapter, вы сможете выполнять задания печати по запросу пользователя с помощью метода PrintManager, print(), который принимает PrintDocumentAdapter в качестве одного из аргументов.

Печать изображений

Если вы хотите напечатать только фотографию или другое растровое изображение, вспомогательные API в библиотеке поддержки сделают за вас всю работу. Просто создайте новый экземпляр PrintHelper, задайте режим масштабирования с помощью setScaleMode(), а затем передайте Bitmap в printBitmap(). Вот и всё! Библиотека выполняет все остальные действия по взаимодействию с системой, чтобы передать растровое изображение на принтер.

Создание служб печати

Если вы производитель принтеров (OEM), то можете использовать фреймворк android.printservice, чтобы обеспечить совместимость своих принтеров с устройствами Android. Вы можете создавать и распространять службы печати в виде APK-файлов, которые пользователи могут устанавливать на свои устройства . Приложение службы печати работает в основном как консольный сервис, используя подкласс PrintService, который получает задания на печать от системы и передает их на принтеры по соответствующим протоколам.

Подробнее о том, как печатать контент из приложения…

Поставщик SMS-услуг

Поставщик контента Telephony (поставщик SMS) позволяет приложениям читать и писать SMS и MMS на устройстве. В нем есть таблицы для полученных, отправленных, ожидающих отправки и других SMS- и MMS-сообщений.

Начиная с Android 4.4, в настройках системы можно выбрать приложение для обмена SMS по умолчанию. После выбора только стандартное приложение для обмена SMS сможет записывать данные в SMS Provider и только стандартное приложение для обмена SMS будет получать широковещательное сообщение SMS_DELIVER_ACTION, когда пользователь получает SMS, или WAP_PUSH_DELIVER_ACTION, когда пользователь получает MMS-сообщение. Стандартное приложение для обмена SMS отвечает за запись сведений в поставщик SMS, когда получает или отправляет новое сообщение.

Другие приложения, не выбранные в качестве приложения для обмена SMS по умолчанию, могут только читать данные поставщика SMS, но также могут получать уведомления о поступлении новых SMS, прослушивая широковещательную рассылку SMS_RECEIVED_ACTION, которая не может быть прервана и может быть доставлена нескольким приложениям. Это широковещательное сообщение предназначено для приложений, которые не выбраны в качестве приложения для обмена SMS по умолчанию, но которым нужно читать специальные входящие сообщения, например для подтверждения номера телефона.

Подробную информацию вы найдете в записи блога Getting Your SMS Apps Ready for KitKat (Подготовка приложений для обмена SMS к работе в KitKat).

Беспроводная связь и подключение

Технология Host Card Emulation

Приложения для Android теперь могут эмулировать NFC-карты ISO14443-4 (ISO-DEP), которые используют APDU для обмена данными (как указано в ISO7816-4). Это позволяет устройству с поддержкой NFC и ОС Android 4.4 эмулировать несколько карт NFC одновременно, а кассовому терминалу или другому считывателю NFC – инициировать транзакцию с соответствующей картой NFC на основе идентификатора приложения (AID).

Если вы хотите эмулировать в приложении карту NFC, использующую эти протоколы, создайте компонент сервиса на основе класса HostApduService. Если же в приложении для эмуляции карты используется защитный элемент, вам нужно создать сервис на основе класса OffHostApduService. Он не будет напрямую участвовать в транзакциях, но необходим для регистрации идентификаторов приложений, которые должны обрабатываться защитным элементом.

Подробную информацию вы найдете в руководстве по эмуляции карт NFC.

Режим считывателя NFC

Новый режим чтения NFC позволяет ограничить все действия NFC только чтением типов тегов, которые интересуют действие, когда оно находится на переднем плане. Вы можете включить режим чтения для действия с помощью enableReaderMode(), предоставив реализацию NfcAdapter.ReaderCallback, которая получает обратный вызов при обнаружении новых тегов.

Эта новая возможность в сочетании с технологией Host Card Emulation позволяет Android работать на обоих концах интерфейса мобильных платежей: одно устройство работает как кассовый терминал (устройство, на котором запущено действие в режиме считывателя), а другое – как платежный клиент (устройство, эмулирующее карту NFC).

Инфракрасные передатчики

Если на устройстве есть инфракрасный передатчик, вы можете передавать ИК-сигналы с помощью API ConsumerIrManager. Чтобы получить экземпляр ConsumerIrManager, вызовите getSystemService() с аргументом CONSUMER_IR_SERVICE. Затем вы можете запросить поддерживаемые устройством ИК-частоты с помощью getCarrierFrequencies() и передать сигналы, указав нужную частоту и шаблон сигнала с помощью transmit().

Сначала всегда проверяйте, есть ли на устройстве ИК-передатчик, вызывая hasIrEmitter(). Если ваше приложение совместимо только с устройствами, на которых он есть, добавьте элемент <uses-feature> в манифест для "android.hardware.consumerir" (FEATURE_CONSUMER_IR).

Мультимедиа

Адаптивное воспроизведение

В API MediaCodec теперь поддерживается адаптивное воспроизведение видео, что позволяет плавно менять разрешение во время воспроизведения на Surface. Вы можете подавать на вход декодера кадры с новым разрешением, и разрешение выходных буферов будет меняться без значительных задержек.

Чтобы включить адаптивное воспроизведение, добавьте в MediaFormat два ключа, которые указывают максимальное разрешение, требуемое вашему приложению от кодека: KEY_MAX_WIDTH и KEY_MAX_HEIGHT. Добавив их в MediaFormat, передайте MediaFormat в экземпляр MediaCodec с помощью configure().

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

Чтобы изменить разрешение при декодировании видео H.264, продолжайте ставить кадры в очередь с помощью MediaCodec.queueInputBuffer(), но обязательно укажите новые значения набора параметров последовательности (SPS) и набора параметров изображения (PPS) вместе с кадром мгновенного обновления декодера (IDR) в одном буфере.

Однако перед настройкой кодека для адаптивного воспроизведения необходимо убедиться, что устройство поддерживает эту функцию. Для этого вызовите isFeatureSupported(String) с FEATURE_AdaptivePlayback.

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

Временные метки аудио по запросу

Чтобы упростить синхронизацию аудио и видео, новый класс AudioTimestamp предоставляет подробные сведения о временной шкале для определенного кадра в аудиопотоке, обрабатываемом AudioTrack. Чтобы получить последнюю доступную временную метку, создайте экземпляр объекта AudioTimestamp и передайте его в getTimestamp(). Если запрос временной метки выполнен успешно, экземпляр AudioTrack заполняется позицией в единицах кадра вместе с расчетным временем, когда этот кадр был представлен или должен быть представлен.

Вы можете использовать значение nanoTime в AudioTimestamp (которое является монотонным), чтобы найти ближайший связанный кадр видео по сравнению с framePosition. Это позволит вам удалять, дублировать или интерполировать кадры видео в соответствии со звуком. Вы также можете определить разницу между значением nanoTime и ожидаемым временем будущего кадра видео (с учетом частоты дискретизации), чтобы предсказать, какой аудиокадр ожидается в тот же момент, что и кадр видео.

Программа чтения с экрана

Новый API ImageReader предоставляет прямой доступ к буферам изображений, когда они отрисовываются в Surface. Получить ImageReader можно с помощью статического метода newInstance(). Затем вызовите getSurface(), чтобы создать новый Surface и передать данные изображения с помощью поставщика, например MediaPlayer или MediaCodec. Чтобы получать уведомления о новых изображениях, реализуйте интерфейс ImageReader.OnImageAvailableListener и зарегистрируйте его с помощью setOnImageAvailableListener().

Теперь, когда вы рисуете контент в Surface, ваш ImageReader.OnImageAvailableListener получает вызов onImageAvailable() по мере того, как становится доступен каждый новый кадр изображения, предоставляя вам соответствующий ImageReader. Вы можете использовать ImageReader, чтобы получить данные изображения кадра в виде объекта Image, вызвав acquireLatestImage() или acquireNextImage().

Объект Image предоставляет прямой доступ к временной метке, формату, размерам и пиксельным данным изображения в ByteBuffer. Однако для того, чтобы класс Image мог интерпретировать ваши изображения, они должны быть отформатированы в соответствии с одним из типов, определенных константами в ImageFormat или PixelFormat.

Измерение пикового и среднеквадратичного значения

Теперь вы можете запрашивать пиковое и среднеквадратичное значения текущего аудиопотока из Visualizer, создав новый экземпляр Visualizer.MeasurementPeakRms и передав его в getMeasurementPeakRms(). При вызове этого метода пиковое и среднеквадратичное значения заданного Visualizer.MeasurementPeakRms устанавливаются равными последним измеренным значениям.

Усилитель громкости

LoudnessEnhancer – это новый подкласс AudioEffect, который позволяет увеличить громкость MediaPlayer или AudioTrack. Это может быть особенно полезно в сочетании с новым методом getMeasurementPeakRms(), упомянутым ранее, чтобы увеличить громкость голосовых аудиодорожек во время воспроизведения других медиафайлов.

Пульты дистанционного управления

В Android 4.0 (уровень API 14) появились API RemoteControlClient, которые позволяют мультимедийным приложениям использовать события контроллера мультимедиа от удаленных клиентов, например элементов управления мультимедиа на заблокированном экране. Новые API RemoteController позволяют создавать собственные пульты дистанционного управления, а также инновационные приложения и периферийные устройства, которые могут управлять воспроизведением в любом мультимедийном приложении, интегрированном с RemoteControlClient.

Чтобы создать пульт дистанционного управления, вы можете реализовать пользовательский интерфейс любым удобным для вас способом, но для доставки событий мультимедийных кнопок в мультимедийное приложение пользователя необходимо создать сервис, который расширяет класс NotificationListenerService и реализует интерфейс RemoteController.OnClientUpdateListener. Использование NotificationListenerService в качестве основы важно, поскольку он обеспечивает надлежащие ограничения конфиденциальности, которые требуют от пользователей включить ваше приложение в качестве прослушивателя уведомлений в настройках безопасности системы.

Класс NotificationListenerService включает несколько абстрактных методов, которые необходимо реализовать. Однако если вас интересуют только события контроллера мультимедиа для обработки воспроизведения, вы можете оставить их реализацию пустой и сосредоточиться на методах RemoteController.OnClientUpdateListener.

Оценки от удаленных контроллеров

В Android 4.4 расширены возможности клиентов удаленного управления (приложений, которые получают события управления мультимедиа с помощью RemoteControlClient). Теперь пользователи могут оценивать текущий трек с пульта дистанционного управления.

Новый класс Rating содержит информацию об оценке пользователя. Оценка определяется ее стилем (RATING_HEART, RATING_THUMB_UP_DOWN, RATING_3_STARS, RATING_4_STARS, RATING_5_STARS или RATING_PERCENTAGE) и значением, которое подходит для этого стиля.

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

Чтобы получать обратный вызов, когда пользователь меняет оценку с помощью пульта дистанционного управления, реализуйте новый интерфейс RemoteControlClient.OnMetadataUpdateListener и передайте экземпляр в setMetadataUpdateListener(). Когда пользователь меняет оценку, ваш RemoteControlClient.OnMetadataUpdateListener получает вызов onMetadataUpdate(), передавая RATING_KEY_BY_USER в качестве ключа и объект Rating в качестве значения.

Субтитры

VideoView теперь поддерживает субтитры WebVTT при воспроизведении видео с потоковой передачей данных по HTTP (HLS). Субтитры показываются в соответствии с настройками, заданными пользователем в системе.

Вы также можете передавать в VideoView субтитры в формате WebVTT с помощью метода addSubtitleSource(). Этот метод принимает объект InputStream, который содержит данные субтитров, и объект MediaFormat, который указывает формат данных субтитров, который можно указать с помощью createSubtitleFormat(). Эти субтитры также показываются поверх видео в соответствии с настройками пользователя.

Если вы не используете VideoView для показа видеоконтента, то должны сделать так, чтобы оверлей субтитров максимально соответствовал настройкам субтитров пользователя. Новый API CaptioningManager позволяет запрашивать настройки субтитров пользователя, включая стили, определенные CaptioningManager.CaptionStyle, такие как гарнитура и цвет. Если пользователь изменит настройки после начала воспроизведения видео, вы должны отследить эти изменения, зарегистрировав экземпляр CaptioningManager.CaptioningChangeListener, чтобы получить обратный вызов при изменении настроек, а затем обновить субтитры.

Анимация и графика

Сцены и переходы

Новый фреймворк android.transition предоставляет API, которые упрощают анимацию между разными состояниями пользовательского интерфейса. Ключевой особенностью является возможность определять различные состояния пользовательского интерфейса, известные как «сцены», путем создания отдельного макета для каждого из них. Чтобы анимировать переход от одной сцены к другой, выполните переход, который рассчитывает необходимую анимацию для изменения макета с текущей сцены на следующую.

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

  1. Укажите ViewGroup, содержащий компоненты интерфейса, которые вы хотите изменить.
  2. Укажите макет, представляющий конечный результат изменения (следующую сцену).
  3. Укажите тип перехода, который должен анимировать изменение макета.
  4. Выполните переход.

Для выполнения шагов 1 и 2 можно использовать объект Scene. Scene содержит метаданные, описывающие свойства макета, необходимые для выполнения перехода, включая родительское представление сцены и макет сцены. Вы можете создать Scene с помощью конструктора класса или статического метода getSceneForLayout().

Затем вам нужно будет использовать TransitionManager, чтобы выполнить шаги 3 и 4. Один из способов – передать Scene в статический метод go(). При этом в текущем макете будет найден родительский вид сцены и выполнен переход к дочерним видам, чтобы достичь макета, определенного в Scene.

Вы также можете не создавать объект Scene, а вызвать метод beginDelayedTransition(), указав ViewGroup, содержащий представления, которые вы хотите изменить. Затем добавьте, удалите или измените целевые представления. После того как система внесет необходимые изменения, начнется переход, который анимирует все затронутые представления.

Для дополнительного контроля вы можете определить наборы переходов, которые должны происходить между предопределенными сценами, используя XML-файл в каталоге res/transition/ вашего проекта. Внутри элемента <transitionManager> укажите один или несколько тегов <transition>, каждый из которых определяет сцену (ссылку на файл макета) и переход, который будет применяться при входе в эту сцену и/или выходе из нее. Затем разверните этот набор переходов с помощью inflateTransitionManager(). Используйте возвращенный TransitionManager, чтобы выполнить каждый переход с помощью transitionTo(), передав Scene, представленный одним из тегов <transition>. Вы также можете программно определить наборы переходов с помощью API TransitionManager.

При указании перехода можно использовать несколько предопределенных типов, определенных подклассами Transition, например Fade и ChangeBounds. Если вы не укажете тип перехода, система по умолчанию использует AutoTransition, который автоматически затухает, перемещает и изменяет размер представлений по мере необходимости. Кроме того, вы можете создавать собственные переходы, расширяя любой из этих классов, чтобы выполнять анимацию так, как вам нужно. Специальный переход может отслеживать любые изменения свойств и создавать на их основе любую анимацию. Например, вы можете создать подкласс Transition, который будет отслеживать изменения свойства rotation в представлении и анимировать их.

Подробную информацию вы найдете в документации по TransitionManager.

Приостановка анимации

Теперь API Animator позволяют приостанавливать и возобновлять анимацию с помощью методов pause() и resume().

Чтобы отслеживать состояние анимации, можно реализовать интерфейс Animator.AnimatorPauseListener, который предоставляет обратные вызовы при приостановке и возобновлении анимации: pause() и resume(). Затем добавьте прослушиватель в объект Animator с помощью addPauseListener().

Вы также можете создать подкласс абстрактного класса AnimatorListenerAdapter, который теперь включает пустые реализации для обратных вызовов приостановки и возобновления, определенных Animator.AnimatorPauseListener.

Многоразовые растровые изображения

Теперь вы можете повторно использовать любую изменяемую битовую карту в BitmapFactory для декодирования любой другой битовой карты, даже если новая битовая карта имеет другой размер, при условии, что результирующее количество байтов декодированной битовой карты (доступно в getByteCount()) меньше или равно выделенному количеству байтов повторно используемой битовой карты (доступно в getAllocationByteCount()). Дополнительную информацию можно найти по адресу inBitmap.

Новые API для Bitmap позволяют выполнять аналогичную реконфигурацию для повторного использования за пределами BitmapFactory (для ручного создания растровых изображений или пользовательской логики декодирования). Теперь вы можете задавать размеры битовой карты с помощью методов setHeight() и setWidth(), а также указывать новое значение Bitmap.Config с помощью setConfig(), не влияя на базовое распределение битовой карты. Метод reconfigure() также позволяет объединить эти изменения в одном вызове.

Однако не следует перенастраивать битовую карту, которая в настоящее время используется системой просмотра, поскольку базовый буфер пикселей не будет переназначен предсказуемым образом.

Пользовательский контент

Storage Access Framework

В предыдущих версиях Android, чтобы получить файл определенного типа из другого приложения, нужно было вызвать намерение с действием ACTION_GET_CONTENT. Это действие по-прежнему подходит для запроса файла, который вы хотите импортировать в приложение. Однако в Android 4.4 появилось действие ACTION_OPEN_DOCUMENT, которое позволяет пользователю выбрать файл определенного типа и предоставить приложению долгосрочный доступ к нему для чтения (и, возможно, записи) без импорта в приложение.

Если вы разрабатываете приложение, которое предоставляет услуги хранения файлов (например, сервис сохранения в облаке), вы можете использовать этот унифицированный интерфейс для выбора файлов, реализовав поставщика контента как подкласс нового класса DocumentsProvider. Ваш подкласс DocumentsProvider должен включать фильтр интентов, который принимает действие PROVIDER_INTERFACE ("android.content.action.DOCUMENTS_PROVIDER"). Затем вам нужно реализовать четыре абстрактных метода в DocumentsProvider:

queryRoots()
Этот метод должен возвращать объект Cursor, который описывает все корневые каталоги хранилища документов, используя столбцы, определенные в DocumentsContract.Root.
queryChildDocuments()
Этот метод должен возвращать объект Cursor, который описывает все файлы в указанном каталоге, используя столбцы, определенные в DocumentsContract.Document.
queryDocument()
Этот метод должен возвращать объект Cursor, описывающий указанный файл, с использованием столбцов, определенных в DocumentsContract.Document.
openDocument()
Она должна возвращать объект ParcelFileDescriptor, представляющий указанный файл. Система вызывает этот метод, когда пользователь выбирает файл, а клиентское приложение запрашивает доступ к нему, вызывая openFileDescriptor().

Подробную информацию можно найти в руководстве Storage Access Framework.

Доступ к внешнему хранилищу

Теперь вы можете читать и записывать файлы, относящиеся к приложению, на дополнительных внешних носителях, например когда устройство предоставляет как эмулированное хранилище, так и SD-карту. Новый метод getExternalFilesDirs() работает так же, как и существующий метод getExternalFilesDir(), но возвращает массив объектов File. Прежде чем читать или записывать данные по любому из путей, возвращенных этим методом, передайте объект File новому методу getStorageState(), чтобы проверить, доступно ли хранилище в данный момент.

Другие методы доступа к каталогу кеша приложения и каталогу OBB теперь также имеют соответствующие версии, которые обеспечивают доступ к дополнительным устройствам хранения: getExternalCacheDirs() и getObbDirs() соответственно.

Первая запись в возвращенном массиве File считается основным внешним хранилищем устройства, которое совпадает с File, возвращенным существующими методами, такими как getExternalFilesDir().

Примечание. Начиная с Android 4.4, приложению больше не требуется получать разрешение WRITE_EXTERNAL_STORAGE или READ_EXTERNAL_STORAGE, если ему нужен доступ только к собственным областям внешнего хранилища, полученным с помощью методов выше. Однако разрешения необходимы, если вы хотите получить доступ к общим областям внешнего хранилища, предоставляемым getExternalStoragePublicDirectory().

Адаптеры синхронизации

Новый метод requestSync() в ContentResolver упрощает определение запроса на синхронизацию для ContentProvider, инкапсулируя запросы в новом объекте SyncRequest, который можно создать с помощью SyncRequest.Builder. Свойства в SyncRequest предоставляют те же функции, что и существующие вызовы синхронизации ContentProvider, но добавляют возможность указать, что синхронизация должна быть отменена, если сеть тарифицируется, путем включения setDisallowMetered().

Ввод данных пользователями

Новые типы датчиков

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

В Android теперь также поддерживаются встроенные аппаратные датчики шагов:

TYPE_STEP_DETECTOR
Этот датчик активирует событие каждый раз, когда пользователь делает шаг. При каждом шаге пользователя этот датчик передает событие со значением 1,0 и временной меткой, указывающей, когда был сделан шаг.
TYPE_STEP_COUNTER
Этот датчик также активирует событие при каждом обнаруженном шаге, но вместо этого передает общее накопленное количество шагов с момента первой регистрации этого датчика приложением.

Обратите внимание, что эти два датчика шагов не всегда дают одинаковые результаты. События TYPE_STEP_COUNTER происходят с большей задержкой, чем события TYPE_STEP_DETECTOR, но это связано с тем, что алгоритм TYPE_STEP_COUNTER выполняет дополнительную обработку для устранения ложных срабатываний. Поэтому TYPE_STEP_COUNTER может передавать события медленнее, но результаты должны быть точнее.

Оба датчика шагов зависят от аппаратного обеспечения (Nexus 5 – первое устройство, которое их поддерживает), поэтому вам следует проверить доступность с помощью hasSystemFeature(), используя константы FEATURE_SENSOR_STEP_DETECTOR и FEATURE_SENSOR_STEP_COUNTER.

Пакетные события датчиков

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

Чтобы обеспечить пакетную передачу, класс SensorManager добавляет две новые версии метода registerListener(), которые позволяют указать максимальную задержку отчета. Этот новый параметр указывает максимальную задержку, которую SensorEventListener может допустить при доставке новых событий датчика. Например, если вы укажете задержку в одну минуту, система будет передавать пакеты событий с интервалом не более одной минуты, последовательно вызывая метод onSensorChanged() для каждого события в пакете. События датчика никогда не будут задерживаться дольше, чем указано в значении максимальной задержки отчета, но могут поступать раньше, если другие приложения запросили меньшую задержку для того же датчика.

Однако учтите, что датчик будет передавать пакеты событий в приложение с учетом задержки отчетов, только когда ЦП активен. Хотя аппаратный датчик, поддерживающий пакетную обработку, будет продолжать собирать события датчика, пока ЦП находится в спящем режиме, он не будет выводить ЦП из спящего режима для доставки пакетных событий в ваше приложение. Когда память датчика заполнится, он начнет удалять самые старые события, чтобы сохранить новые. Чтобы не потерять события, вы можете вывести устройство из спящего режима до того, как память датчика заполнится, а затем вызвать flush(), чтобы получить последнюю партию событий. Чтобы оценить, когда память будет заполнена и ее нужно будет очистить, вызовите getFifoMaxEventCount(), чтобы получить максимальное количество событий датчика, которое можно сохранить, и разделите это число на частоту, с которой ваше приложение запрашивает каждое событие. Используйте полученное значение, чтобы настроить будильники с помощью AlarmManager, которые вызывают Service (реализующий SensorEventListener) для очистки датчика.

Примечание. Не все устройства поддерживают пакетную обработку событий датчиков, поскольку для этого требуется поддержка аппаратного датчика. Однако начиная с Android 4.4 всегда следует использовать новые методы registerListener(), поскольку если устройство не поддерживает пакетную обработку, система игнорирует аргумент задержки пакета и доставляет события датчика в режиме реального времени.

Идентификационные данные контролеров

Теперь Android идентифицирует каждый подключенный контроллер с помощью уникального целого числа, которое можно запросить с помощью getControllerNumber(). Это упрощает связывание каждого контроллера с отдельным игроком. Номер каждого контроллера может меняться, когда пользователь отключает, подключает или перенастраивает контроллеры. Поэтому вам нужно отслеживать, какой номер контроллера соответствует каждому устройству ввода, зарегистрировав экземпляр InputManager.InputDeviceListener. Затем вызывайте getControllerNumber() для каждого InputDevice при изменении.

Подключенные устройства теперь также предоставляют идентификаторы продуктов и поставщиков, которые доступны в getProductId() и getVendorId(). Если вам нужно изменить привязку клавиш в зависимости от доступного набора клавиш на устройстве, вы можете запросить устройство, чтобы проверить, доступны ли определенные клавиши, с помощью hasKeys(int...).

Пользовательский интерфейс

Полноэкранный режим с эффектом присутствия

Чтобы макет приложения заполнял весь экран, используйте новый флаг SYSTEM_UI_FLAG_IMMERSIVE для setSystemUiVisibility() (в сочетании с SYSTEM_UI_FLAG_HIDE_NAVIGATION). Он позволяет включить новый иммерсивный полноэкранный режим. Когда включен полноэкранный режим с эффектом присутствия, ваше действие продолжает получать все события касания. Убедитесь, что системные панели открываются, если провести там, где они обычно располагаются. Это очищает флаг SYSTEM_UI_FLAG_HIDE_NAVIGATION (и флаг SYSTEM_UI_FLAG_FULLSCREEN, если он применен), поэтому системные строки остаются видимыми. Однако если вы хотите, чтобы системные строки снова скрывались через несколько секунд, вы можете использовать флаг SYSTEM_UI_FLAG_IMMERSIVE_STICKY.

Полупрозрачные системные строки

Теперь вы можете сделать системные строки частично прозрачными с помощью новых тем Theme.Holo.NoActionBar.TranslucentDecor и Theme.Holo.Light.NoActionBar.TranslucentDecor. Если вы включите полупрозрачные системные строки, макет будет заполнять область за ними. Поэтому вам также нужно включить fitsSystemWindows для той части макета, которая не должна быть закрыта системными строками.

Если вы создаете собственную тему, задайте одну из этих тем в качестве родительской или включите в свою тему свойства стиля windowTranslucentNavigation и windowTranslucentStatus.

Улучшенная служба просмотра уведомлений

В Android 4.3 добавлены API NotificationListenerService, позволяющие приложениям получать информацию о новых уведомлениях, когда они публикуются системой. В Android 4.4 слушатели уведомлений могут получать дополнительные метаданные для уведомления и полные сведения о действиях уведомления:

Новое поле Notification.extras содержит Bundle, чтобы передавать в конструктор уведомлений дополнительные метаданные, такие как EXTRA_TITLE и EXTRA_PICTURE. Новый класс Notification.Action определяет характеристики действия, прикрепленного к уведомлению, которые можно получить из нового поля actions.

Отражение графических объектов для макетов с направлением письма справа налево

В предыдущих версиях Android, если в приложении есть изображения, которые должны менять горизонтальную ориентацию для макетов с направлением письма справа налево, необходимо включить зеркальное изображение в каталог ресурсов drawables-ldrtl/. Теперь система может автоматически зеркально отражать изображения, если вы включите атрибут autoMirrored для прорисовываемого ресурса или вызовете setAutoMirrored(). Если этот параметр включен, Drawable автоматически отражается, когда направление макета справа налево.

Специальные возможности

Класс View теперь позволяет объявлять динамические области для частей интерфейса, которые динамически обновляются новым текстовым контентом. Для этого нужно добавить новый атрибут accessibilityLiveRegion в макет XML или вызвать setAccessibilityLiveRegion(). Например, если на экране входа в систему есть текстовое поле, в котором появляется уведомление "Неверный пароль", его следует пометить как динамическую область. Тогда программа чтения с экрана будет озвучивать сообщение при его изменении.

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

Разрешения приложений

Ниже перечислены новые разрешения, которые ваше приложение должно запрашивать с помощью тега <uses-permission>, чтобы использовать определенные новые API.

INSTALL_SHORTCUT
Приложение сможет добавлять ярлыки на панель запуска.
UNINSTALL_SHORTCUT
Приложение сможет удалять ярлыки на панели запуска.
TRANSMIT_IR
Позволяет приложению использовать ИК-передатчик устройства, если он есть.

Примечание. Начиная с Android 4.4, приложению больше не требуется разрешение WRITE_EXTERNAL_STORAGE или READ_EXTERNAL_STORAGE, чтобы получить доступ к своим разделам внешнего хранилища с помощью таких методов, как getExternalFilesDir(). Однако разрешения по-прежнему требуются, если вы хотите получить доступ к общим областям внешнего хранилища, предоставляемым getExternalStoragePublicDirectory().

Функции устройств

Ниже перечислены новые функции устройств, которые можно указать с помощью тега <uses-feature>, чтобы задать требования приложения и включить фильтрацию в Google Play или проверку во время выполнения.

FEATURE_CONSUMER_IR
Устройство может взаимодействовать с потребительскими ИК-устройствами.
FEATURE_DEVICE_ADMIN
Устройство поддерживает принудительное применение правил для устройств с помощью администраторов устройств.
FEATURE_NFC_HOST_CARD_EMULATION
Устройство поддерживает эмуляцию карт NFC на базе хоста.
FEATURE_SENSOR_STEP_COUNTER
На устройстве есть аппаратный счетчик шагов.
FEATURE_SENSOR_STEP_DETECTOR
Устройство оснащено аппаратным детектором шагов.

Подробные сведения обо всех изменениях API в Android 4.4 приведены в отчете о различиях API.