Android 4.0 API

Уровень API: 14.

Android 4.0 (ICE_CREAM_SANDWICH) – это крупный выпуск платформы, в котором появилось множество новых функций для пользователей и разработчиков приложений. Помимо всех новых функций и API, описанных ниже, Android 4.0 – это важный выпуск платформы, поскольку он переносит обширный набор API и голографических тем из Android 3.x на экраны меньшего размера. Теперь у разработчиков приложений есть единая платформа и унифицированная среда API, позволяющая разрабатывать и публиковать приложения с помощью одного APK-файла, который обеспечивает оптимизированный пользовательский интерфейс для телефонов, планшетов и других устройств, работающих под управлением одной и той же версии Android – Android 4.0 (уровень API 14) или более поздней.

Для разработчиков платформа Android 4.0 доступна в виде скачиваемого компонента для Android SDK. Скачиваемая платформа включает библиотеку Android, образ системы, набор обложек эмулятора и другие компоненты. Чтобы начать разработку или тестирование для Android 4.0, скачайте платформу в SDK с помощью Android SDK Manager.

Общие сведения об API

В разделах ниже приведен технический обзор новых API в Android 4.0.

Social API в поставщике контактов

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

Профиль пользователя

Теперь в Android есть личный профиль, который представляет владельца устройства, как определено в таблице ContactsContract.Profile. Социальные приложения, в которых поддерживается идентификация пользователей, могут добавлять данные в профиль пользователя, создавая новую запись ContactsContract.RawContacts в ContactsContract.Profile. Это значит, что необработанные контакты, представляющие пользователя устройства, не принадлежат к традиционной таблице необработанных контактов, определяемой URI ContactsContract.RawContacts. Вместо этого вы должны добавить необработанный контакт профиля в таблицу по адресу CONTENT_RAW_CONTACTS_URI. Необработанные контакты из этой таблицы затем объединяются в один видимый пользователю профиль с пометкой "Я".

Чтобы добавить новый необработанный контакт в профиль, требуется разрешение android.Manifest.permission#WRITE_PROFILE. Аналогично, чтобы читать данные из таблицы профиля, необходимо запросить разрешение android.Manifest.permission#READ_PROFILE. Однако большинству приложений не требуется считывать профиль пользователя, даже если они добавляют в него данные. Чтение профиля пользователя – это разрешение на доступ к конфиденциальной информации, и вы должны быть готовы к тому, что пользователи будут скептически относиться к приложениям, которые его запрашивают.

Намерение пригласить

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

Чтобы ваше приложение появилось в списке "Добавить связь", в нем должен быть адаптер синхронизации, который позволяет синхронизировать контактную информацию из социальной сети. Затем вы должны указать системе, что ваше приложение реагирует на намерение INVITE_CONTACT, добавив атрибут inviteContactActivity в файл конфигурации синхронизации вашего приложения с полным именем действия, которое система должна запустить при отправке намерения приглашения. Запущенное действие может получить URI нужного контакта из данных намерения и выполнить необходимые действия, чтобы пригласить этот контакт в сеть или добавить его в список контактов пользователя.

Большие фотографии

Теперь Android поддерживает фотографии контактов в высоком разрешении. Теперь, когда вы добавляете фотографию в запись контакта, система обрабатывает ее как в виде уменьшенного изображения размером 96 x 96 (как и раньше), так и в виде "фотографии профиля" размером 256 x 256, которая хранится в новом файловом хранилище фотографий (точные размеры, которые выбирает система, могут измениться в будущем). Чтобы добавить большую фотографию контакта, поместите ее в обычный столбец PHOTO строки данных. Система обработает ее и создаст значок и фотографию контакта.

Отзыв об использовании контактов

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

Поставщик календаря

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

Различные приложения и виджеты могут использовать эти API для чтения и изменения мероприятий в календаре. Однако некоторые из наиболее убедительных вариантов использования – это адаптеры синхронизации, которые синхронизируют календарь пользователя из других служб календаря с поставщиком календаря, чтобы предложить единое местоположение для всех событий пользователя. Например, мероприятия Google Календаря синхронизируются с поставщиком календаря с помощью адаптера синхронизации Google Календаря, что позволяет просматривать эти мероприятия во встроенном приложении "Календарь" на устройстве Android.

Модель данных для календарей и информации о мероприятиях в Calendar Provider определяется классом CalendarContract. Все данные календаря пользователя хранятся в нескольких таблицах, определенных различными подклассами CalendarContract:

  • Таблица CalendarContract.Calendars содержит информацию, относящуюся к календарю. Каждая строка в этой таблице содержит сведения об одном календаре, такие как название, цвет и информация о синхронизации.
  • Таблица CalendarContract.Events содержит информацию о событиях. Каждая строка в этой таблице содержит информацию об одном мероприятии, например название, место проведения, время начала и окончания. Событие может произойти один раз или повторяться несколько раз. Участники, напоминания и расширенные свойства хранятся в отдельных таблицах и используют _ID мероприятия, чтобы связать их с мероприятием.
  • Таблица CalendarContract.Instances содержит время начала и окончания каждого повторения мероприятия. Каждая строка в этой таблице представляет собой отдельный случай. Для однократных мероприятий существует однозначное сопоставление экземпляров с мероприятиями. Для повторяющихся мероприятий автоматически создается несколько строк, соответствующих каждому повторению.
  • Таблица CalendarContract.Attendees содержит информацию об участниках или гостях мероприятия. Каждая строка соответствует одному гостю мероприятия. Он указывает тип гостя и его ответ на приглашение.
  • Таблица CalendarContract.Reminders содержит данные об оповещениях и уведомлениях. Каждая строка представляет собой одно оповещение о событии. Для одного мероприятия можно создать несколько напоминаний. Количество напоминаний для каждого мероприятия указывается в столбце MAX_REMINDERS, который задается адаптером синхронизации, владеющим данным календарем. Напоминания задаются в минутах до запланированного мероприятия и указывают способ оповещения, например использование оповещения, электронной почты или SMS для напоминания пользователю.
  • Таблица CalendarContract.ExtendedProperties содержит поля непрозрачных данных, используемые адаптером синхронизации. Поставщик не выполняет никаких действий с элементами в этой таблице, за исключением их удаления при удалении связанных с ними событий.

Чтобы получить доступ к данным календаря пользователя с помощью поставщика календаря, ваше приложение должно запросить разрешение READ_CALENDAR (для доступа на чтение) и WRITE_CALENDAR (для доступа на запись).

Намерение, связанное с событием

Если вам нужно только добавить мероприятие в календарь пользователя, вы можете использовать намерение ACTION_INSERT с данными, определенными в Events.CONTENT_URI, чтобы запустить в приложении "Календарь" действие, которое создает новые мероприятия. Для использования намерения не требуется разрешение. Вы можете указать сведения о мероприятии с помощью следующих дополнительных параметров:

  • Events.TITLE – название события.
  • CalendarContract.EXTRA_EVENT_BEGIN_TIME – время начала события в миллисекундах с начала эпохи.
  • CalendarContract.EXTRA_EVENT_END_TIME – время окончания события в миллисекундах с начала эпохи.
  • Events.EVENT_LOCATION – место проведения мероприятия.
  • Events.DESCRIPTION: описание события
  • Intent.EXTRA_EMAIL – адреса электронной почты приглашаемых пользователей.
  • Events.RRULE: правило повторения мероприятия.
  • Events.ACCESS_LEVEL – статус мероприятия (общедоступное или закрытое).
  • Events.AVAILABILITY: Позволяет ли период времени этого мероприятия запланировать другие мероприятия на то же время.

Поставщик услуг голосовой почты

Новый поставщик голосовой почты позволяет приложениям добавлять голосовые сообщения на устройство, чтобы показывать их в едином интерфейсе. Например, у пользователя может быть несколько источников голосовой почты: один от поставщика услуг телефона, а другие – от VoIP или других альтернативных голосовых сервисов. Эти приложения могут использовать API поставщика голосовой почты, чтобы добавлять голосовые сообщения на устройство. Встроенное приложение "Телефон" показывает пользователю все голосовые сообщения в едином интерфейсе. Хотя системное приложение "Телефон" – единственное, которое может читать все голосовые сообщения, каждое приложение, предоставляющее голосовые сообщения, может читать те, которые оно добавило в систему (но не может читать голосовые сообщения из других сервисов).

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

Класс VoicemailContract определяет поставщика контента для поставщика голосовой почты. Подклассы VoicemailContract.Voicemails и VoicemailContract.Status предоставляют таблицы, в которые приложения могут вставлять данные голосовой почты для хранения на устройстве. Пример приложения поставщика голосовой почты можно найти в демоверсии.

Мультимедиа

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

Эффекты для медиаконтента

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

Для максимальной производительности эффекты применяются непосредственно к текстурам OpenGL, поэтому перед использованием API эффектов у вашего приложения должен быть действительный контекст OpenGL. Текстуры, к которым вы применяете эффекты, могут быть из растровых изображений, видео или даже камеры. Однако к текстурам предъявляются определенные требования:

  1. Они должны быть привязаны к изображению текстуры GL_TEXTURE_2D.
  2. Они должны содержать хотя бы один уровень MIP-текстурирования.

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

  1. Вызовите EffectContext.createWithCurrentGlContext() из контекста OpenGL ES 2.0.
  2. Используйте возвращенный EffectContext, чтобы вызвать EffectContext.getFactory(), который возвращает экземпляр EffectFactory.
  3. Вызовите createEffect(), передав название эффекта из @link android.media.effect.EffectFactory}, например EFFECT_FISHEYE или EFFECT_VIGNETTE.

Вы можете настроить параметры эффекта, вызвав setParameter() и передав название и значение параметра. Для каждого типа эффекта можно задать разные параметры, которые описаны в документации. Например, у EFFECT_FISHEYE есть один параметр для scale искажения.

Чтобы применить эффект к текстуре, вызовите apply() для Effect и передайте входную текстуру, ее ширину и высоту, а также выходную текстуру. Входная текстура должна быть привязана к изображению текстуры GL_TEXTURE_2D (обычно это делается путем вызова функции glTexImage2D()). Вы можете указать несколько уровней MIP-текстурирования. Если выходная текстура не привязана к изображению текстуры, она будет автоматически привязана эффектом как GL_TEXTURE_2D с одним уровнем MIP-текстуры (0), который будет иметь тот же размер, что и входная текстура.

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

Клиент удаленного управления

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

Чтобы включить клиенты удаленного управления для медиапроигрывателя, создайте экземпляр RemoteControlClient с помощью его конструктора, передав ему PendingIntent, который транслирует ACTION_MEDIA_BUTTON. В намерении также должен быть явно объявлен компонент BroadcastReceiver в вашем приложении, который обрабатывает событие ACTION_MEDIA_BUTTON.

Чтобы указать, какие входные данные элементов управления мультимедиа может обрабатывать ваш проигрыватель, вызовите setTransportControlFlags() в RemoteControlClient, передав набор флагов FLAG_KEY_MEDIA_*, например FLAG_KEY_MEDIA_PREVIOUS и FLAG_KEY_MEDIA_NEXT.

Затем зарегистрируйте RemoteControlClient, передав его в MediaManager.registerRemoteControlClient(). После регистрации широковещательный приемник, объявленный при создании экземпляра RemoteControlClient, будет получать события ACTION_MEDIA_BUTTON при нажатии кнопки на пульте дистанционного управления. Полученный интент включает KeyEvent для нажатой клавиши мультимедиа, которую можно получить из интента с помощью getParcelableExtra(Intent.EXTRA_KEY_EVENT).

Чтобы на пульте дистанционного управления показывалась информация о воспроизводимом медиаконтенте, вызовите editMetaData() и добавьте метаданные в возвращенный объект RemoteControlClient.MetadataEditor. Вы можете предоставить растровое изображение для обложки, числовую информацию, например прошедшее время, и текстовую информацию, например название трека. Информацию о доступных ключах можно найти в разделе METADATA_KEY_* flags в MediaMetadataRetriever.

Пример реализации можно найти в приложении Random Music Player, в котором используется логика совместимости, позволяющая включить клиент удаленного управления на устройствах с Android 4.0 и при этом сохранить поддержку устройств с Android 2.1.

Медиапроигрыватель

  • Для потоковой передачи онлайн-медиа из приложения "MediaPlayer" теперь требуется разрешение "INTERNET". Если вы используете MediaPlayer для воспроизведения контента из интернета, добавьте разрешение INTERNET в манифест. В противном случае воспроизведение медиаконтента не будет работать в Android 4.0 и более поздних версиях.
  • setSurface() позволяет определить Surface, который будет действовать как приемник видео.
  • setDataSource() позволяет отправлять дополнительные HTTP-заголовки с запросом, что может быть полезно для прямых трансляций по HTTP(S).
  • При трансляциях по протоколу HTTP(S) теперь учитываются файлы cookie HTTP в запросах.

Типы медиаконтента

В Android 4.0 добавлена поддержка:

  • Протокол потоковой передачи HTTP/HTTPS версии 3
  • Кодирование звука ADTS raw AAC
  • Изображения WebP
  • Видео Matroska

Подробнее о поддерживаемых медиаформатах…

Камера

Класс Camera теперь включает API для распознавания лиц, управления фокусом и областями замера.

Распознавание лица

Теперь приложения для камеры могут использовать API Android для распознавания лиц, которые не только обнаруживают лицо объекта, но и определяют конкретные черты лица, такие как глаза и рот.

Чтобы распознавать лица в приложении камеры, необходимо зарегистрировать Camera.FaceDetectionListener, вызвав setFaceDetectionListener(). Затем вы можете запустить камеру и начать распознавание лиц, вызвав метод startFaceDetection().

Когда система обнаруживает одно или несколько лиц в кадре, она вызывает обратный вызов onFaceDetection() в вашей реализации Camera.FaceDetectionListener, включая массив объектов Camera.Face.

Экземпляр класса Camera.Face предоставляет различную информацию о распознанном лице, в том числе:

  • Объект Rect, который определяет границы лица относительно текущей зоны обзора камеры.
  • Целое число от 1 до 100, которое указывает, насколько система уверена, что объект является человеческим лицом.
  • Уникальный идентификатор, позволяющий отслеживать несколько лиц.
  • Несколько объектов Point, которые указывают, где находятся глаза и рот.

Примечание. Распознавание лиц может не поддерживаться на некоторых устройствах. Чтобы проверить, поддерживается ли оно, вызовите метод getMaxNumDetectedFaces() и убедитесь, что возвращаемое значение больше нуля. Кроме того, некоторые устройства могут не поддерживать распознавание глаз и рта. В этом случае соответствующие поля в объекте Camera.Face будут иметь значение null.

Области фокусировки и экспозамера

Теперь приложения камеры могут управлять областями, которые камера использует для фокусировки, а также для измерения баланса белого и автоматической экспозиции. Обе функции используют новый класс Camera.Area, чтобы указать область текущего вида камеры, на которой нужно сфокусироваться или которую нужно измерить. Экземпляр класса Camera.Area определяет границы области с помощью Rect и вес области, представляющий уровень важности этой области по отношению к другим рассматриваемым областям, с помощью целого числа.

Прежде чем задавать область фокусировки или экспозамера, вызовите метод getMaxNumFocusAreas() или getMaxNumMeteringAreas() соответственно. Если возвращается ноль, значит устройство не поддерживает соответствующую функцию.

Чтобы указать области фокусировки или замера, вызовите setFocusAreas() или setMeteringAreas(). Каждый из них принимает List объектов Camera.Area, которые указывают области, которые следует учитывать для фокусировки или замера. Например, вы можете реализовать функцию, которая позволяет пользователю установить область фокусировки, коснувшись области предварительного просмотра, которую вы затем преобразуете в объект Camera.Area и запрашиваете, чтобы камера фокусировалась на этой области сцены. Фокус или экспозиция в этой области будут постоянно обновляться по мере изменения сцены.

Постоянный автофокус для фото

Теперь при съемке фотографий можно включить непрерывный автофокус. Чтобы включить непрерывную автофокусировку в приложении камеры, передайте FOCUS_MODE_CONTINUOUS_PICTURE в setFocusMode(). Когда будете готовы сделать снимок, вызовите autoFocus(). Ваш объект Camera.AutoFocusCallback сразу же получит обратный вызов, указывающий, был ли достигнут фокус. Чтобы возобновить работу CAF после получения обратного вызова, необходимо вызвать cancelAutoFocus().

Примечание. Постоянный автофокус также поддерживается при съемке видео с помощью FOCUS_MODE_CONTINUOUS_VIDEO, который был добавлен в API уровня 9.

Другие функции камеры

  • Теперь во время записи видео можно вызвать takePicture(), чтобы сделать фото, не прерывая съемку. Перед этим вызовите isVideoSnapshotSupported(), чтобы убедиться, что аппаратное обеспечение поддерживает эту функцию.
  • Теперь вы можете заблокировать автоматическую экспозицию и баланс белого с помощью setAutoExposureLock() и setAutoWhiteBalanceLock(), чтобы предотвратить изменение этих свойств.
  • Теперь вы можете вызвать setDisplayOrientation() во время предварительного просмотра камеры. Раньше этот метод можно было вызывать только до начала предварительного просмотра, но теперь ориентацию можно изменить в любой момент.

Объекты intent для трансляции с камеры

  • Camera.ACTION_NEW_PICTURE: Пользователь сделал новую фотографию. Встроенное приложение "Камера" вызывает эту трансляцию после съемки фотографии. Сторонние приложения камеры также должны транслировать это намерение после съемки фотографии.
  • Camera.ACTION_NEW_VIDEO: Пользователь снял новое видео. Встроенное приложение "Камера" вызывает эту трансляцию после записи видео. Сторонние приложения камеры также должны транслировать это намерение после съемки видео.

Android Beam (NDEF Push с NFC)

Android Beam – это новая функция NFC, которая позволяет отправлять сообщения NDEF с одного устройства на другое (этот процесс также называется NDEF Push). Передача данных начинается, когда два устройства Android, поддерживающие Android Beam, находятся в непосредственной близости (около 4 см), обычно соприкасаясь задними панелями. Сообщение NDEF может содержать любые данные, которыми вы хотите поделиться с другими устройствами. Например, приложение "Контакты" передает контакты, YouTube – видео, а браузер – URL-адреса.

Чтобы передавать данные между устройствами с помощью Android Beam, вам нужно создать объект NdefMessage, содержащий информацию, которой вы хотите поделиться, пока ваше действие находится на переднем плане. Затем необходимо передать NdefMessage в систему одним из двух способов:

  • Определите один объект NdefMessage, который будет отправляться во время действия:

    Позвоните по номеру setNdefPushMessage() в любое время, чтобы задать сообщение, которое вы хотите отправить. Например, вы можете вызвать этот метод и передать ему NdefMessage во время метода onCreate() вашего объекта activity. Затем, когда Android Beam активируется с другим устройством, пока действие находится на переднем плане, система отправляет NdefMessage на другое устройство.

  • Определите NdefMessage, который будет передаваться при запуске Android Beam:

    Реализуйте NfcAdapter.CreateNdefMessageCallback, в котором ваша реализация метода createNdefMessage() возвращает NdefMessage, который вы хотите отправить. Затем передайте реализацию NfcAdapter.CreateNdefMessageCallback в setNdefPushMessageCallback().

    В этом случае, когда Android Beam активируется с другим устройством, пока ваше действие находится на переднем плане, система вызывает createNdefMessage(), чтобы получить NdefMessage, которое вы хотите отправить. Это позволяет определить NdefMessage, который будет доставлен только после запуска Android Beam, если содержимое сообщения может меняться в течение всего времени действия.

Если вы хотите запустить определенный код после того, как система успешно доставит ваше сообщение NDEF на другое устройство, вы можете реализовать NfcAdapter.OnNdefPushCompleteCallback и установить его с помощью setNdefPushCompleteCallback(). После доставки сообщения система позвонит на номер onNdefPushComplete().

На принимающем устройстве система отправляет сообщения NDEF Push так же, как и обычные теги NFC. Система вызывает намерение с действием ACTION_NDEF_DISCOVERED, чтобы запустить действие с URL или MIME-типом, заданным в соответствии с первым элементом NdefRecord в NdefMessage. Для объекта activity, на который вы хотите ответить, вы можете объявить фильтры интентов для URL-адресов или MIME-типов, которые важны для вашего приложения. Дополнительную информацию о Tag Dispatch можно найти в руководстве для разработчиков NFC.

Если вы хотите, чтобы объект NdefMessage содержал URI, вы можете использовать удобный метод createUri, чтобы создать новый объект NdefRecord на основе строки или объекта Uri. Если URI имеет специальный формат, который вы хотите, чтобы ваше приложение также получало во время события Android Beam, вам следует создать фильтр интентов для вашего объекта activity, используя ту же схему URI, чтобы получать входящее сообщение NDEF.

Вам также следует передать запись приложения для Android вместе с NdefMessage, чтобы гарантировать, что ваше приложение обрабатывает входящее сообщение NDEF, даже если другие приложения фильтруют то же действие интента. Чтобы создать запись о приложении для Android, вызовите метод createApplicationRecord(), передав ему название пакета приложения. Когда другое устройство получает сообщение NDEF с записью приложения, а несколько приложений содержат действия, обрабатывающие указанное намерение, система всегда доставляет сообщение действию в вашем приложении (на основе соответствующей записи приложения). Если на целевом устройстве не установлено ваше приложение, система использует запись приложения для Android, чтобы запустить Google Play и перенаправить пользователя на страницу приложения для его установки.

Если ваше приложение не использует API NFC для отправки сообщений NDEF Push, то Android предоставляет режим работы по умолчанию: когда ваше приложение находится на переднем плане на одном устройстве и Android Beam вызывается с другим устройством на базе Android, то другое устройство получает сообщение NDEF с записью приложения для Android, которая идентифицирует ваше приложение. Если на принимающем устройстве установлено приложение, система запускает его. Если нет, открывается Google Play, где пользователь может установить приложение.

Подробнее об Android Beam и других функциях NFC можно узнать в руководстве для разработчиков. Пример кода с использованием Android Beam можно найти в демоверсии Android Beam.

Wi-Fi P2P

Теперь Android поддерживает одноранговые соединения Wi-Fi между устройствами Android и другими типами устройств (в соответствии с программой сертификации Wi-Fi Direct™ от Wi-Fi Alliance) без точки доступа или подключения к интернету. Фреймворк Android предоставляет набор API для Wi-Fi P2P, которые позволяют обнаруживать другие устройства и подключаться к ним, если они поддерживают Wi-Fi P2P. Затем вы можете обмениваться данными по высокоскоростному соединению на расстояниях, значительно превышающих расстояние соединения Bluetooth.

Новый пакет android.net.wifi.p2p содержит все API для одноранговых подключений по Wi-Fi. Основной класс, с которым вам нужно работать, – WifiP2pManager. Его можно получить, вызвав getSystemService(WIFI_P2P_SERVICE). WifiP2pManager включает API, которые позволяют:

  • Инициализируйте приложение для P2P-подключений, вызвав initialize().
  • Обнаружение устройств поблизости с помощью вызова discoverPeers()
  • Начните P2P-подключение, позвонив по номеру connect().
  • и многое другое.

Также необходимы некоторые другие интерфейсы и классы, например:

  • Интерфейс WifiP2pManager.ActionListener позволяет получать обратные вызовы, когда операция, например обнаружение устройств или подключение к ним, завершается успешно или с ошибкой.
  • Интерфейс WifiP2pManager.PeerListListener позволяет получать информацию об обнаруженных одноранговых узлах. Обратный вызов предоставляет WifiP2pDeviceList, из которого вы можете получить объект WifiP2pDevice для каждого устройства в пределах диапазона и получить такую информацию, как название устройства, адрес, тип устройства, поддерживаемые устройством конфигурации WPS и многое другое.
  • Интерфейс WifiP2pManager.GroupInfoListener позволяет получать информацию о группе P2P. Обратный вызов предоставляет объект WifiP2pGroup, который содержит информацию о группе, например о владельце, названии сети и кодовой фразе.
  • Интерфейс WifiP2pManager.ConnectionInfoListener позволяет получать информацию о текущем подключении. Обратный вызов предоставляет объект WifiP2pInfo, который содержит информацию о том, сформирована ли группа и кто является ее владельцем.

Чтобы использовать API Wi-Fi P2P, приложение должно запрашивать у пользователя следующие разрешения:

  • ACCESS_WIFI_STATE
  • CHANGE_WIFI_STATE
  • INTERNET (хотя приложение технически не подключается к интернету, для связи с одноранговыми узлами Wi-Fi P2P с помощью стандартных сокетов Java требуется разрешение на доступ к интернету).

Система Android также транслирует несколько различных действий во время определенных событий Wi-Fi P2P:

Дополнительную информацию можно найти в документации по WifiP2pManager. Также ознакомьтесь с примером приложения Wi-Fi P2P Demo.

Устройства для контроля за здоровьем с Bluetooth

Android теперь поддерживает устройства с профилем Bluetooth Health Profile, поэтому вы можете создавать приложения, которые используют Bluetooth для связи с медицинскими устройствами, поддерживающими Bluetooth, такими как пульсометры, тонометры, термометры и весы.

Как и в случае с обычной гарнитурой и устройствами с профилем A2DP, чтобы установить подключение к объекту прокси-сервера профиля, необходимо вызвать getProfileProxy() с BluetoothProfile.ServiceListener и типом профиля HEALTH.

После получения прокси-объекта профиля здоровья (BluetoothHealth) для подключения к сопряженным устройствам и обмена данными с ними используются следующие новые классы Bluetooth:

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

Дополнительную информацию об использовании профиля Bluetooth Health можно найти в документации по BluetoothHealth.

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

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

Режим изучения касанием

Пользователи с нарушениями зрения могут перемещать палец по экрану, чтобы прослушивать описания контента. Поскольку режим изучения касанием работает как виртуальный курсор, он позволяет программам чтения с экрана идентифицировать описательный текст так же, как и при навигации с помощью d-pad или трекбола, – считывая информацию, предоставляемую методами android:contentDescription и setContentDescription() при имитации события наведения. Поэтому не забывайте добавлять описания для представлений в приложении, особенно для ImageButton, EditText, ImageView и других виджетов, которые могут не содержать описательного текста.

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

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

Прежде всего следует отметить, что в Android 4.0 изменилось поведение метода sendAccessibilityEvent(). Как и в предыдущих версиях Android, когда пользователь включает специальные возможности на устройстве и происходит событие ввода, например клик или наведение указателя, соответствующее представление получает уведомление с вызовом sendAccessibilityEvent(). Ранее реализация sendAccessibilityEvent() инициализировала AccessibilityEvent и отправляла его в AccessibilityManager. Новое поведение включает дополнительные методы обратного вызова, которые позволяют представлению и его родительским элементам добавлять в событие больше контекстной информации:

  1. При вызове методы sendAccessibilityEvent() и sendAccessibilityEventUnchecked() откладываются до onInitializeAccessibilityEvent().

    В пользовательских реализациях View может потребоваться реализовать onInitializeAccessibilityEvent(), чтобы добавить в AccessibilityEvent дополнительные сведения о специальных возможностях. При этом также следует вызвать суперреализацию, чтобы предоставить информацию по умолчанию, например стандартное описание контента, индекс элемента и т. д. Однако не добавляйте в этот обратный вызов дополнительный текстовый контент – это делается на следующем этапе.

  2. Если событие относится к одному из нескольких типов, которые должны быть заполнены текстовой информацией, то после инициализации представление получает вызов dispatchPopulateAccessibilityEvent(), который откладывается до обратного вызова onPopulateAccessibilityEvent().

    Специальные реализации View обычно должны реализовывать onPopulateAccessibilityEvent(), чтобы добавлять дополнительный текстовый контент в AccessibilityEvent, если текст android:contentDescription отсутствует или его недостаточно. Чтобы добавить текстовое описание к AccessibilityEvent, вызовите getText().add().

  3. В этот момент View передает событие вверх по иерархии View, вызывая requestSendAccessibilityEvent() в родительском View. Каждое родительское представление может дополнить информацию о специальных возможностях, добавив AccessibilityRecord, пока она не достигнет корневого представления, которое отправляет событие в AccessibilityManager с помощью sendAccessibilityEvent().

Помимо новых методов, описанных выше, которые полезны при расширении класса View, вы также можете перехватывать эти обратные вызовы событий в любом View, расширив AccessibilityDelegate и установив его в представлении с помощью setAccessibilityDelegate(). В этом случае каждый метод специальных возможностей в представлении откладывает вызов соответствующего метода в делегате. Например, когда представление получает вызов onPopulateAccessibilityEvent(), оно передает его тому же методу в View.AccessibilityDelegate. Все методы, не обработанные делегатом, возвращаются в представление для выполнения действий по умолчанию. Это позволяет переопределять только те методы, которые необходимы для конкретного представления, без расширения класса View.

Если вы хотите сохранить совместимость с версиями Android до 4.0 и при этом поддерживать новые Accessibility API, используйте последнюю версию библиотеки поддержки v4 (в пакете совместимости r4). В ней есть набор служебных классов, которые обеспечивают обратную совместимость новых Accessibility API.

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

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

Если вы разрабатываете сервис специальных возможностей (например, программу чтения с экрана), то можете получить доступ к дополнительной информации о контенте и перемещаться по иерархиям View, выполнив следующие действия:

  1. Получив от приложения объект AccessibilityEvent, вызовите метод AccessibilityEvent.getRecord(), чтобы получить определенный объект AccessibilityRecord (к событию может быть прикреплено несколько записей).
  2. Вы можете вызвать метод getSource() для объекта AccessibilityEvent или отдельного объекта AccessibilityRecord, чтобы получить объект AccessibilityNodeInfo.

    AccessibilityNodeInfo представляет собой один узел содержимого окна в формате, который позволяет запрашивать информацию о специальных возможностях этого узла. Объект AccessibilityNodeInfo, возвращаемый из AccessibilityEvent, описывает источник события, а источник из AccessibilityRecord описывает предшественника источника события.

  3. С помощью AccessibilityNodeInfo вы можете запрашивать информацию о нем, вызывать getParent() или getChild() для обхода иерархии View и даже добавлять дочерние View в узел.

Чтобы приложение могло зарегистрироваться в системе как сервис специальных возможностей, оно должно объявить XML-файл конфигурации, соответствующий AccessibilityServiceInfo. Подробнее о создании сервиса специальных возможностей рассказывается в статье AccessibilityService, а о конфигурации XML – в статье SERVICE_META_DATA.

Другие Accessibility API

Если вас интересует состояние специальных возможностей устройства, в AccessibilityManager есть новые API, например:

  • AccessibilityManager.AccessibilityStateChangeListener  – это интерфейс, который позволяет получать обратный вызов при включении или отключении специальных возможностей.
  • getEnabledAccessibilityServiceList() предоставляет информацию о том, какие специальные возможности включены в данный момент.
  • isTouchExplorationEnabled() сообщает, включен ли режим изучения касанием.

Сервисы проверки правописания

Новая платформа проверки правописания позволяет приложениям создавать средства проверки правописания аналогично платформе метода ввода (для IME). Чтобы создать новую проверку правописания, необходимо реализовать сервис, который расширяет SpellCheckerService, и расширить класс SpellCheckerService.Session, чтобы предлагать исправления правописания на основе текста, предоставленного методами обратного вызова интерфейса. В методах обратного вызова SpellCheckerService.Session необходимо возвращать исправления правописания в виде объектов SuggestionsInfo.

Приложения со службой проверки правописания должны запрашивать разрешение BIND_TEXT_SERVICE, как того требует служба. Сервис также должен объявить фильтр интентов с <action android:name="android.service.textservice.SpellCheckerService" /> в качестве действия интента и содержать элемент <meta-data>, который объявляет информацию о конфигурации для проверки правописания.

Примеры кода можно найти в приложениях Spell Checker Service и Spell Checker Client.

Синтезаторы речи

API синтеза речи (TTS) в Android были значительно расширены, чтобы приложениям было проще реализовывать собственные механизмы TTS. При этом приложения, которые хотят использовать механизм TTS, получили пару новых API для выбора механизма.

Как использовать системы синтеза речи

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

Вы также можете запросить доступные системы синтеза речи с помощью getEngines(). Этот метод возвращает список объектов TextToSpeech.EngineInfo, которые включают метаданные, такие как значок, ярлык и название пакета.

Создание систем синтеза речи

Ранее для создания собственных поисковых систем требовалось использовать недокументированный заголовочный файл. В Android 4.0 есть полный набор API фреймворка для создания систем синтеза речи.

Для базовой настройки требуется реализация TextToSpeechService, которая отвечает на намерение INTENT_ACTION_TTS_SERVICE. Основная работа синтезатора речи выполняется во время обратного вызова onSynthesizeText() в сервисе, который расширяет TextToSpeechService. Система передает этому методу два объекта:

  • SynthesisRequest: содержит различные данные, включая текст для синтеза, региональные настройки, скорость речи и высоту голоса.
  • SynthesisCallback – интерфейс, с помощью которого система TTS передает полученные аудиоданные в виде потокового аудио. Сначала движок должен вызвать start(), чтобы указать, что он готов к передаче аудио, а затем вызвать audioAvailable(), передав ему аудиоданные в байтовом буфере. Когда весь звук пройдет через буфер, вызовите done().

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

Пример системы синтеза речи, использующей новые API, см. в примере приложения Text To Speech Engine.

Использование сети

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

Если ваше приложение выполняет много сетевых транзакций, вы должны предоставить пользователям настройки, позволяющие контролировать использование данных приложением, например, как часто приложение синхронизирует данные, выполнять ли загрузку/скачивание только при подключении к Wi-Fi, использовать ли данные в роуминге и т. д. С помощью этих элементов управления пользователи с гораздо меньшей вероятностью отключат доступ вашего приложения к данным, когда они приблизятся к своим лимитам, потому что вместо этого они могут точно контролировать, сколько данных использует ваше приложение. Если вы предоставляете объект activity настроек с этими параметрами, то в его объявлении в файле манифеста должен быть фильтр интентов для действия ACTION_MANAGE_NETWORK_USAGE. Пример:

<activity android:name="DataPreferences" android:label="@string/title_preferences">
    <intent-filter>
       <action android:name="android.intent.action.MANAGE_NETWORK_USAGE" />
       <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

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

Также обратите внимание, что метод getBackgroundDataSetting() больше не поддерживается и всегда возвращает значение true. Вместо него используйте метод getActiveNetworkInfo(). Прежде чем пытаться выполнить какие-либо сетевые транзакции, всегда вызывайте getActiveNetworkInfo(), чтобы получить NetworkInfo, представляющий текущую сеть, и запрашивайте isConnected(), чтобы проверить, есть ли у устройства подключение. Затем вы можете проверить другие свойства подключения, например находится ли устройство в роуминге или подключено ли оно к Wi-Fi.

Enterprise

В Android 4.0 расширены возможности корпоративных приложений.

VPN-сервисы

Новый VpnService позволяет приложениям создавать собственные VPN (виртуальные частные сети), работающие как Service. Сервис VPN создает интерфейс для виртуальной сети с собственным адресом и правилами маршрутизации, а также выполняет все операции чтения и записи с помощью дескриптора файла.

Чтобы создать VPN-сервис, используйте VpnService.Builder. С его помощью можно указать сетевой адрес, DNS-сервер, сетевой маршрут и другие параметры. После этого вы можете создать интерфейс, вызвав метод establish(), который возвращает ParcelFileDescriptor.

Поскольку VPN-сервис может перехватывать пакеты, это может повлиять на безопасность. Поэтому если вы реализуете VpnService, то ваш сервис должен запрашивать разрешение BIND_VPN_SERVICE, чтобы к нему могла подключаться только система (это разрешение предоставляется только системе, приложения не могут его запрашивать). Чтобы использовать VPN-сервис, пользователям нужно вручную включить его в системных настройках.

Правила для устройств

Приложения, управляющие ограничениями на устройстве, теперь могут отключать камеру с помощью setCameraDisabled() и свойства USES_POLICY_DISABLE_CAMERA (применяется с элементом <disable-camera /> в файле конфигурации правил).

Управление сертификатами

Новый класс KeyChain предоставляет API, позволяющие импортировать сертификаты в системное хранилище ключей и получать к ним доступ. Сертификаты упрощают установку сертификатов клиента (для подтверждения личности пользователя) и сертификатов центра сертификации (для подтверждения личности сервера). Приложения, например браузеры или почтовые клиенты, могут использовать установленные сертификаты для аутентификации пользователей на серверах. Дополнительную информацию можно найти в документации по KeyChain.

Датчики устройств

В Android 4.0 добавлены два новых типа датчиков:

  • TYPE_AMBIENT_TEMPERATURE – датчик температуры, который измеряет температуру окружающей среды (комнаты) в градусах Цельсия.
  • TYPE_RELATIVE_HUMIDITY – датчик влажности, который определяет относительную влажность воздуха в помещении в процентах.

Если на устройстве есть датчики TYPE_AMBIENT_TEMPERATURE и TYPE_RELATIVE_HUMIDITY, вы можете использовать их для расчета точки росы и абсолютной влажности.

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

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

Панель действий

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

Разделенная панель действий

Если на панели действий несколько элементов, не все они поместятся на узком экране, поэтому система поместит часть из них в дополнительное меню. Однако в Android 4.0 можно включить разделенную панель действий, чтобы на экране в отдельной панели внизу отображалось больше элементов действий. Чтобы включить разделенную панель действий, добавьте android:uiOptions со значением "splitActionBarWhenNarrow" в тег <application> или отдельные теги <activity> в файле манифеста. Если этот параметр включен, система добавит дополнительную панель внизу экрана для всех задач, когда экран узкий (задачи не будут отображаться на основной панели действий).

Если вы хотите использовать вкладки навигации, предоставляемые API ActionBar.Tab, но вам не нужна основная панель действий вверху (вы хотите, чтобы вверху отображались только вкладки), включите разделенную панель действий, как описано выше, а также вызовите setDisplayShowHomeEnabled(false), чтобы отключить значок приложения на панели действий. Когда на панели действий ничего не остается, она исчезает. На экране остаются только вкладки навигации вверху и задачи внизу.

Стили панели действий

Если вы хотите применить к панели действий собственный стиль, используйте новые свойства стиля backgroundStacked и backgroundSplit, чтобы применить фоновое изображение или цвет к составной и разделенной панели соответственно. Вы также можете задать эти стили во время выполнения с помощью setStackedBackgroundDrawable() и setSplitBackgroundDrawable().

Поставщик действий

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

Например, ShareActionProvider – это расширение ActionProvider, которое позволяет поделиться контентом с помощью панели действий. Вместо традиционной задачи, которая вызывает интент ACTION_SEND, вы можете использовать этот поставщик действий, чтобы представить представление действия с раскрывающимся списком приложений, которые обрабатывают интент ACTION_SEND. Когда пользователь выбирает приложение для действия, ShareActionProvider запоминает этот выбор и показывает его в представлении действия, чтобы пользователь мог быстрее поделиться контентом с помощью этого приложения.

Чтобы объявить поставщика действий для задачи, включите атрибут android:actionProviderClass в элемент <item> для меню параметров действия, указав в качестве значения название класса поставщика действий. Пример:

<item android:id="@+id/menu_share"
      android:title="Share"
      android:showAsAction="ifRoom"
      android:actionProviderClass="android.widget.ShareActionProvider" />

В методе обратного вызова onCreateOptionsMenu() своего объекта activity получите экземпляр поставщика действий из пункта меню и задайте намерение:

Kotlin

override fun onCreateOptionsMenu(menu: Menu): Boolean {
    menuInflater.inflate(R.menu.options, menu)
    val shareActionProvider = menu.findItem(R.id.menu_share)?.actionProvider as? ShareActionProvider
    // Set the share intent of the share action provider.
    shareActionProvider?.setShareIntent(createShareIntent())
    ...
    return super.onCreateOptionsMenu(menu)
}

Java

public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.options, menu);
    ShareActionProvider shareActionProvider =
          (ShareActionProvider) menu.findItem(R.id.menu_share).getActionProvider();
    // Set the share intent of the share action provider.
    shareActionProvider.setShareIntent(createShareIntent());
    ...
    return super.onCreateOptionsMenu(menu);
}

Пример использования ShareActionProvider можно найти в разделе ActionBarShareActionProviderActivity в ApiDemos.

Сворачиваемые представления действий

Объекты ActionItem, которые предоставляют ActionView, теперь могут переключаться между состоянием ActionView и традиционным состоянием ActionItem. Ранее только SearchView поддерживал сворачивание при использовании в качестве представления действия, но теперь вы можете добавить представление действия для любого элемента действия и переключаться между развернутым состоянием (представление действия видно) и свернутым состоянием (элемент действия виден).

Чтобы объявить, что объект действия, содержащий представление действия, можно свернуть, включите флаг "collapseActionView" в атрибут android:showAsAction для элемента <item> в XML-файле меню.

Чтобы получать обратные вызовы при переключении между развернутым и свернутым режимами, зарегистрируйте экземпляр MenuItem.OnActionExpandListener с соответствующим MenuItem, вызвав setOnActionExpandListener(). Обычно это делается во время обратного вызова onCreateOptionsMenu().

Чтобы управлять сворачиваемым представлением действия, вы можете вызвать collapseActionView() и expandActionView() для соответствующего MenuItem.

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

Другие API для панели действий

  • setHomeButtonEnabled() позволяет указать, будет ли значок или логотип работать как кнопка для перехода на главную страницу или на уровень выше (для этого передайте значение true).
  • setIcon() и setLogo() позволяют определить значок или логотип панели действий во время выполнения.
  • Fragment.setMenuVisibility() позволяет включать или отключать видимость элементов меню параметров, объявленных фрагментом. Это полезно, если фрагмент был добавлен в действие, но не виден, поэтому пункты меню должны быть скрыты.
  • FragmentManager.invalidateOptionsMenu() позволяет аннулировать меню параметров действия на разных этапах жизненного цикла фрагмента, когда эквивалентный метод из Activity может быть недоступен.

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

В Android 4.0 появились новые представления и другие компоненты интерфейса.

GridLayout

GridLayout – это новый класс View Group, который размещает дочерние представления в прямоугольной сетке. В отличие от TableLayout, GridLayout использует плоскую иерархию и не использует промежуточные представления, такие как строки таблицы, для обеспечения структуры. Вместо этого дочерние элементы указывают, какие строки и столбцы они должны занимать (ячейки могут охватывать несколько строк и/или столбцов), и по умолчанию располагаются последовательно по строкам и столбцам сетки. Ориентация GridLayout определяет, как по умолчанию располагаются дочерние элементы – горизонтально или вертикально. Расстояние между дочерними элементами можно задать с помощью экземпляров нового представления Space или путем настройки соответствующих параметров полей для дочерних элементов.

Примеры использования GridLayout можно найти в ApiDemos.

TextureView

TextureView – это новый вид, который позволяет показывать поток контента, например видео или сцену OpenGL. Хотя TextureView похож на SurfaceView, он уникален тем, что ведет себя как обычное представление, а не создает отдельное окно, поэтому вы можете обращаться с ним как с любым другим объектом View. Например, вы можете применять преобразования, анимировать его с помощью ViewPropertyAnimator или настраивать его непрозрачность с помощью setAlpha().

Обратите внимание, что TextureView работает только в окне с аппаратным ускорением.

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

Переключатель

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

С помощью атрибутов android:textOn и android:textOff можно указать текст, который будет отображаться на переключателе в положениях "включено" и "выключено". Атрибут android:text также позволяет разместить рядом с переключателем ярлык.

Пример использования переключателей можно найти в файле макета switches.xml и соответствующем действии Switches.

В Android 3.0 появился класс PopupMenu, позволяющий создавать короткие контекстные меню, которые появляются в указанной точке привязки (обычно в точке выбранного элемента). В Android 4.0 PopupMenu расширен за счет нескольких полезных функций:

  • Теперь вы можете легко заполнить всплывающее меню содержимым из ресурса меню XML с помощью inflate(), передав ему идентификатор ресурса меню.
  • Теперь вы также можете создать объект PopupMenu.OnDismissListener, который получает обратный вызов при закрытии меню.

Настройки

Новый абстрактный класс TwoStatePreference служит основой для настроек, которые предоставляют возможность выбора из двух состояний. Новый класс SwitchPreference расширяет возможности TwoStatePreference, добавляя виджет Switch в представление настроек. Это позволяет пользователям включать и отключать параметры, не открывая дополнительный экран или диалоговое окно. Например, в приложении "Настройки" SwitchPreference используется для параметров Wi-Fi и Bluetooth.

Системные темы

Тема по умолчанию для всех приложений, предназначенных для Android 4.0 (для этого нужно задать для targetSdkVersion или minSdkVersion значение "14" или выше), теперь является темой по умолчанию для устройства: Theme.DeviceDefault. Это может быть тёмная тема Holo или другая тёмная тема, заданная на конкретном устройстве.

Темы семейства Theme.Holo гарантированно не меняются от устройства к устройству, если на них установлена одна и та же версия Android. Если вы явно примените любую из тем Theme.Holo к своим действиям, вы можете быть уверены, что эти темы не изменят характер на разных устройствах в одной и той же версии платформы.

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

Кнопка "меню параметров"

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

Для удобства пользователей в новых и обновленных приложениях рекомендуется использовать ActionBar, чтобы предоставлять доступ к пунктам меню, и задавать для targetSdkVersion значение "14", чтобы использовать преимущества последних режимов работы фреймворка по умолчанию.

Настройки видимости системного интерфейса

С первых дней существования Android система управляла компонентом пользовательского интерфейса, известным как строка состояния, которая находится в верхней части мобильных устройств и предоставляет такую информацию, как сигнал оператора связи, время и уведомления. В Android 3.0 для планшетов была добавлена системная строка, которая находится внизу экрана и содержит элементы управления системой (например, кнопки "Домой" и "Назад"), а также интерфейс для элементов, которые обычно находятся в строке состояния. В Android 4.0 появился новый тип системного интерфейса – панель навигации. Панель навигации можно рассматривать как перенастроенную версию системной строки, предназначенную для телефонов. Она предоставляет элементы управления навигацией для устройств, у которых нет аппаратных аналогов для навигации по системе, но не содержит пользовательский интерфейс уведомлений и элементы управления настройками системной строки. Таким образом, устройство, на котором есть панель навигации, также имеет строку состояния вверху.

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

  • Параметр SYSTEM_UI_FLAG_LOW_PROFILE заменяет параметр STATUS_BAR_HIDDEN. Этот флаг включает режим "низкий профиль" для системной строки или панели навигации. Кнопки навигации становятся тусклыми, а другие элементы системной строки скрываются. Это позволяет создавать более захватывающие игры, в которых системные кнопки навигации не отвлекают пользователя.
  • Флаг SYSTEM_UI_FLAG_VISIBLE заменяет флаг STATUS_BAR_VISIBLE, чтобы запрашивать видимость системной строки или панели навигации.
  • SYSTEM_UI_FLAG_HIDE_NAVIGATION – это новый флаг, который запрашивает полное скрытие панели навигации. Обратите внимание, что это работает только для панели навигации, которая используется на некоторых телефонах. На планшетах системная строка не скрывается. Панель навигации снова появляется, как только система получает пользовательский ввод. Поэтому этот режим полезен в основном для воспроизведения видео или других случаев, когда требуется весь экран, но ввод пользователя не требуется.

Вы можете установить каждый из этих флагов для системной строки и панели навигации, вызвав setSystemUiVisibility() для любого представления в вашем действии. Менеджер окон объединяет (побитовое ИЛИ) все флаги из всех представлений в вашем окне и применяет их к системному интерфейсу, пока ваше окно находится в фокусе ввода. Когда окно теряет фокус ввода (пользователь переходит в другое приложение или появляется диалоговое окно), флаги перестают действовать. Аналогично, если вы удалите эти объекты View из иерархии View, их флаги больше не будут применяться.

Чтобы синхронизировать другие события в вашем действии с изменениями видимости системного интерфейса (например, скрыть панель действий или другие элементы управления пользовательского интерфейса, когда системный интерфейс скрывается), вам следует зарегистрировать View.OnSystemUiVisibilityChangeListener, чтобы получать уведомления об изменении видимости системной строки или панели навигации.

Примеры различных вариантов системного интерфейса можно найти в классе OverscanActivity.

Фреймворк ввода

В Android 4.0 добавлена поддержка событий наведения курсора и новых событий стилуса и кнопок мыши.

События наведения указателя

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

Чтобы получать события наведения в представлении, реализуйте View.OnHoverListener и зарегистрируйте его с помощью setOnHoverListener(). Когда в представлении происходит событие наведения, прослушиватель получает вызов onHover(), предоставляя View, который получил событие, и MotionEvent, описывающий тип произошедшего события наведения. Событие наведения может быть одним из следующих:

Если View.OnHoverListener обрабатывает событие наведения, то onHover() должен возвращать значение true. Если прослушиватель возвращает значение false, событие наведения указателя будет отправлено родительскому представлению, как обычно.

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

Пример использования новых событий наведения можно найти в классе Hover в ApiDemos.

события кнопок стилуса и мыши;

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

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

Приложение может различать ввод пальцем, мышью, стилусом и ластиком, запрашивая тип инструмента, связанный с каждым указателем в MotionEvent, с помощью getToolType(). В настоящее время определены следующие типы инструментов: TOOL_TYPE_UNKNOWN, TOOL_TYPE_FINGER, TOOL_TYPE_MOUSE, TOOL_TYPE_STYLUS и TOOL_TYPE_ERASER. Запросив тип инструмента, приложение может по-разному обрабатывать ввод стилусом, пальцем или мышью.

Приложение также может запрашивать, какие кнопки мыши или стилуса нажаты, запрашивая "состояние кнопки" MotionEvent с помощью getButtonState(). В настоящее время определены следующие состояния кнопок: BUTTON_PRIMARY, BUTTON_SECONDARY, BUTTON_TERTIARY, BUTTON_BACK и BUTTON_FORWARD. Для удобства кнопки мыши "Назад" и "Вперед" автоматически сопоставляются с клавишами KEYCODE_BACK и KEYCODE_FORWARD. Приложение может обрабатывать эти клавиши, чтобы поддерживать навигацию назад и вперед с помощью кнопок мыши.

Помимо точного измерения положения и давления контакта, некоторые устройства ввода стилуса также сообщают расстояние между кончиком стилуса и дигитайзером, угол наклона стилуса и угол ориентации стилуса. Приложение может запрашивать эту информацию с помощью getAxisValue() с кодами осей AXIS_DISTANCE, AXIS_TILT и AXIS_ORIENTATION.

Примеры типов инструментов, состояний кнопок и новых кодов осей можно найти в классе TouchPaint в ApiDemos.

Свойства

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

Например, если вы хотите задать значение поля bar для объекта foo, то раньше вы бы сделали следующее:

Kotlin

foo.bar = value

Java

foo.bar = value;

Если вы хотите вызвать метод set для базового закрытого поля bar, ранее вы бы сделали следующее:

Kotlin

foo.setBar(value)

Java

foo.setBar(value);

Однако если вы хотите передать экземпляр foo и задать значение bar в другом коде, то в версиях до Android 4.0 это сделать невозможно.

Используя класс Property, вы можете объявить объект Property BAR в классе Foo, чтобы задать поле в экземпляре foo класса Foo следующим образом:

Kotlin

BAR.set(foo, value)

Java

BAR.set(foo, value);

Класс View теперь использует класс Property, чтобы вы могли задавать различные поля, например свойства преобразования, добавленные в Android 3.0 (ROTATION, ROTATION_X, TRANSLATION_X и т. д.).

Класс ObjectAnimator также использует класс Property, поэтому вы можете создать ObjectAnimator с помощью Property. Это быстрее, эффективнее и безопаснее, чем подход на основе строк.

Аппаратное ускорение

Начиная с Android 4.0, аппаратное ускорение для всех окон включено по умолчанию, если в приложении для targetSdkVersion или minSdkVersion задано значение "14" или выше. Аппаратное ускорение обычно обеспечивает более плавную анимацию и прокрутку, а также повышает общую производительность и скорость отклика на действия пользователя.

При необходимости вы можете вручную отключить аппаратное ускорение с помощью атрибута hardwareAccelerated для отдельных элементов <activity> или элемента <application>. Вы также можете отключить аппаратное ускорение для отдельных представлений, вызвав метод setLayerType(LAYER_TYPE_SOFTWARE).

Дополнительную информацию об аппаратном ускорении, включая список неподдерживаемых операций рисования, можно найти в документе Аппаратное ускорение.

Изменения JNI

В предыдущих версиях Android локальные ссылки JNI не были косвенными дескрипторами, а использовались прямые указатели. Это не было проблемой, пока сборщик мусора не перемещал объекты, но, похоже, это работало, потому что позволяло писать код с ошибками. В Android 4.0 для обнаружения таких ошибок используются косвенные ссылки.

Подробные сведения о локальных ссылках JNI приведены в разделе "Локальные и глобальные ссылки" в советах по JNI. В Android 4.0 функция CheckJNI была улучшена, чтобы обнаруживать такие ошибки. Следите за блогом для разработчиков Android, чтобы не пропустить публикацию о распространенных ошибках, связанных со ссылками JNI, и способах их устранения.

Это изменение в реализации JNI затрагивает только приложения, предназначенные для Android 4.0, в которых для параметра targetSdkVersion или minSdkVersion задано значение "14" или выше. Если вы установили для этих атрибутов более низкое значение, локальные ссылки JNI будут работать так же, как и в предыдущих версиях.

WebKit

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

Браузер Android

Приложение Browser добавляет следующие функции для поддержки веб-приложений:

Разрешения

Ниже перечислены новые разрешения.

  • ADD_VOICEMAIL – позволяет сервису голосовой почты добавлять сообщения на устройство.
  • BIND_TEXT_SERVICE. Сервис, реализующий SpellCheckerService, должен запрашивать это разрешение для себя.
  • BIND_VPN_SERVICE. Сервис, реализующий VpnService, должен запрашивать это разрешение для себя.
  • android.Manifest.permission#READ_PROFILE: предоставляет доступ на чтение к поставщику ContactsContract.Profile.
  • android.Manifest.permission#WRITE_PROFILE: предоставляет доступ на запись к поставщику ContactsContract.Profile.

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

Новые функции устройств:

  • FEATURE_WIFI_DIRECT – указывает, что приложение использует Wi-Fi для одноранговых подключений.

Подробные сведения обо всех изменениях API в Android 4.0 (уровень API 14) можно найти в отчете о различиях API.

Предыдущие API

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

Вот некоторые из наиболее заметных API, которые вы могли пропустить и которые теперь доступны и на телефонах:

Android 3.0
  • Fragment – компонент фреймворка, который позволяет разделять отдельные элементы действия на автономные модули, определяющие собственный интерфейс и жизненный цикл. Подробную информацию можно найти в руководстве для разработчиков.
  • ActionBar – замена традиционной строки заголовка в верхней части окна действия. В левом углу находится логотип приложения, а пункты меню представлены в новом интерфейсе. Подробную информацию вы найдете в руководстве для разработчиков.
  • Loader – компонент фреймворка, который упрощает асинхронную загрузку данных в сочетании с компонентами интерфейса для динамической загрузки данных без блокировки основного потока. Подробная информация приведена в руководстве для разработчиков.
  • Системный буфер обмена. Приложения могут копировать и вставлять данные (не только текст) в системный буфер обмена и из него. Это может быть обычный текст, URI или намерение. Ознакомьтесь с руководством для разработчиков по копированию и вставке.
  • Перетаскивание. Набор API, встроенных в фреймворк View, который упрощает операции перетаскивания. Ознакомьтесь с руководством по перетаскиванию для разработчиков.
  • Новая гибкая платформа анимации позволяет анимировать произвольные свойства любого объекта (View, Drawable, Fragment, Object и т. д.) и определять такие аспекты анимации, как длительность, интерполяция, повтор и т. д. Новый фреймворк делает анимацию в Android проще, чем когда-либо. Подробную информацию вы найдете в руководстве по анимации свойств.
  • Графический и вычислительный движок RenderScript. RenderScript предлагает высокопроизводительный API для рендеринга и вычислений в 3D-графике на нативном уровне. Он написан на языке C (стандарт C99) и обеспечивает производительность, ожидаемую от нативной среды, оставаясь при этом переносимым на различные ЦП и графические процессоры. Ознакомьтесь с руководством для разработчиков по RenderScript.
  • Аппаратное ускорение 2D-графики. Теперь вы можете включить рендерер OpenGL для своего приложения, задав {android:hardwareAccelerated="true"} в элементе <application> манифеста или для отдельных элементов <activity>. Это обеспечивает более плавную анимацию, плавную прокрутку, а также повышает общую производительность и скорость отклика на действия пользователя.

    Примечание. Если в приложении для атрибута minSdkVersion или targetSdkVersion задано значение "14" или выше, аппаратное ускорение включено по умолчанию.

  • и многое другое. Подробную информацию можно найти в примечаниях к выпуску Android 3.0.
Android 3.1
  • USB API. Новые мощные API для интеграции подключенных периферийных устройств с приложениями для Android. API основаны на стеке USB и сервисах, встроенных в платформу, включая поддержку взаимодействия как с хостом, так и с устройством USB. Подробная информация приведена в руководстве для разработчиков USB-хоста и аксессуаров.
  • MTP/PTP API. Приложения могут напрямую взаимодействовать с подключенными камерами и другими устройствами PTP, чтобы получать уведомления о подключении и отключении устройств, управлять файлами и хранилищем на этих устройствах, а также передавать файлы и метаданные на них и с них. MTP API реализует подмножество PTP (Picture Transfer Protocol) спецификации MTP (Media Transfer Protocol). Ознакомьтесь с документацией по android.mtp.
  • RTP API. Android предоставляет API для встроенного стека RTP (протокола передачи данных в реальном времени), который приложения могут использовать для управления потоковой передачей данных по запросу или в интерактивном режиме. В частности, приложения, которые предоставляют услуги VoIP, Push-to-Talk, конференц-связи и аудиопотоков, могут использовать API для инициирования сеансов и передачи или приема потоков данных по любой доступной сети. Ознакомьтесь с документацией по android.net.rtp.
  • Поддержка джойстиков и других устройств ввода.
  • Дополнительную информацию о новых API можно найти в примечаниях к выпуску платформы Android 3.1.
Android 3.2
  • Новые API для экранов позволяют лучше контролировать, как приложения отображаются на экранах разных размеров. API расширяет существующую модель поддержки экранов, позволяя точно настраивать таргетинг на определенные диапазоны размеров экранов по размерам, измеряемым в единицах пикселей, независимых от плотности (например, шириной 600 dp или 720 dp), а не по их обобщенным размерам (например, большим или очень большим). Например, это важно, чтобы вы могли различать устройства с диагональю 5 и 7 дюймов, которые традиционно относятся к категории "большие экраны". Подробнее об этом рассказывается в записи блога.
  • Новые константы для <uses-feature>, позволяющие объявлять требования к горизонтальной или вертикальной ориентации экрана.
  • Теперь при изменении ориентации экрана меняется и конфигурация размера экрана. Если ваше приложение поддерживает целевой уровень API 13 или выше, вы должны обрабатывать изменение конфигурации "screenSize", если хотите обрабатывать изменение конфигурации "orientation". Подробнее: android:configChanges.
  • Информацию о других новых API можно найти в примечаниях к выпуску платформы Android 3.2.

Уровень API

Android 4.0 API присвоен целочисленный идентификатор 14, который хранится в самой системе. Этот идентификатор, называемый уровнем API, позволяет системе правильно определить, совместимо ли приложение с системой, перед установкой приложения.

Чтобы использовать в приложении API, представленные в Android 4.0, необходимо скомпилировать приложение для платформы Android, которая поддерживает API уровня 14 или выше. В зависимости от ваших потребностей вам также может потребоваться добавить атрибут android:minSdkVersion="14" к элементу <uses-sdk>.

Подробнее об уровнях API…