Как реализовать функцию "Экстренная помощь"

Согласно требованиям Министерства телекоммуникаций Индии, все мобильные устройства, продаваемые в этой стране с 1 января 2017 года, должны быть оснащены кнопкой тревоги. Чтобы соответствовать этим требованиям, в Android реализована функция "Экстренная помощь", которая позволяет добавить на устройство кнопку SOS.

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

Примеры и источник

Функция "Экстренная помощь" реализована в проекте Android Open Source Project (AOSP) frameworks/base. Она доступна в последней версии Android и включена по умолчанию в Android 8.0 и более поздних версиях.

Эта функция доступна в следующих ветках и коммитах. Эта информация предоставляется, чтобы производители устройств могли внести необходимые изменения в существующие сборки. Производители устройств, которые хотят реализовать функцию Emergency Affordance в AOSP, могут выборочно скопировать изменения из соответствующих ветвей в свои сборки.

Таблица 1. Выборочно скопированные изменения для функции Emergency Affordance в AOSP

Ветка Фиксации
android-latest-release e0c3c66 Добавлена функция "Экстренная помощь".
42a4338 Добавлены переводы для строки экстренных действий.
4df8d64 Исправлена ошибка, из-за которой функция "Экстренная помощь" показывалась на планшетах.
nougat-dev e6680d9 Добавлена функция "Экстренная помощь".
95e1865 Добавлены переводы для строки экстренных действий.
a70bb89 Исправлена ошибка, из-за которой функция "Экстренная помощь" показывалась на планшетах.
marshmallow-dev cd22634 Добавлена функция "Экстренная помощь"
13f51c6 Добавлены переводы строки экстренного действия
6531666 Исправлена проблема, из-за которой функция "Экстренная помощь" показывалась на планшетах
lollipop-mr1-dev 5fbc86b Добавлена функция "Экстренное действие"
1b60879 Добавлены переводы строки экстренного действия
d74366f Исправлена проблема, из-за которой функция "Экстренное действие" показывалась на планшетах

Реализация

Функция Emergency Affordance не вносит никаких изменений в API, предоставляемые через пакет средств разработки Android (SDK). Если функция включена и активирована, она предоставляет два триггера, которые могут инициировать экстренный вызов по номеру 112. Это единый номер экстренной службы, который должен использоваться в Индии и предусмотрен правилами Министерства телекоммуникаций Индии.

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

Нажатие и удержание кнопки Экстренный вызов
на заблокированном экране.
Нажатие на пункт Экстренный вызов
в меню глобальных действий.
Заблокированный экран с кнопкой "Экстренный вызов"

Рисунок 1. Кнопка "Экстренный вызов" на экране блокировки.

Глобальное меню действий с выбранным вариантом "Экстренная ситуация"

Рисунок 2. Экстренное действие в меню глобальных действий (открывается долгим нажатием кнопки питания).

Эта функция включает следующие внутренние компоненты:

  • EmergencyAffordanceManager
        frameworks/base/core/java/com/android/internal/policy/EmergencyAffordanceManager.java
        
  • EmergencyAffordanceService
        frameworks/base/services/core/java/com/android/server/emergency/EmergencyAffordanceService.java
        

EmergencyAffordanceManager

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

  • void performEmergencyCall(). Начать экстренный вызов.
  • boolean needsEmergencyAffordance(). Определяет, должна ли функция быть активной.

Функцию можно отключить навсегда во время сборки, изменив константу EmergencyAffordanceManager.ENABLED на false. В результате needsEmergencyAffordance() всегда возвращает false, а EmergencyAffordanceService не запускается.

EmergencyAffordanceService

EmergencyAffordanceService – это системная служба, которая отслеживает код страны мобильной связи (MCC) всех обнаруженных мобильных сетей и код страны мобильной связи (MCC) установленных SIM-карт. Если у какой-либо из установленных SIM-карт или обнаруженных мобильных сетей код страны совпадает с одним из кодов Индии (404 или 405), функция будет включена. Это означает, что функцию можно включить в Индии, даже если SIM-карта отсутствует. Предполагается, что мобильная сеть позволяет регистрироваться для экстренных вызовов даже без установленной SIM-карты. Функция остается включенной, пока не будет установлена SIM-карта, выпущенная не в Индии, и ни одна из обнаруженных сетей не будет иметь соответствующий код страны.

На работу функции "Экстренная помощь" влияют следующие ресурсы и настройки: Если тип конфигурации:

  • Ресурс. Внутренний ресурс, определенный в frameworks/base/core/res/res/values/config.xml.
  • Настройка. Настройка, хранящаяся в поставщике системных настроек.

Таблица 2. Настройки, влияющие на работу функции "Экстренная помощь"

Тип конфигурации Название Описание
Ресурс config_emergency_call_number Номер телефона, который автоматически набирается при экстренном вызове.
Тип: строка
Значение по умолчанию: 112
Ресурс config_emergency_mcc_codes Массив целых чисел, в котором перечислены MCC, где должна быть активна функция.
Тип: массив целых чисел.
Значение по умолчанию: {404,405}.
Параметр emergency_affordance_number Переопределение глобальной настройки с номером для экстренного вызова. Это влияет только на образы сборок, доступных для отладки (то есть сборок типа userdebug или eng). Это предназначено только для тестирования.
Тип: строка.
Значение по умолчанию: не задано.
Параметр force_emergency_affordance Глобальный параметр, определяющий, должна ли функция "Экстренная помощь" показываться независимо от состояния устройства. Это предназначено только для тестирования.
Тип: логическое значение (1 или 0)
Значение по умолчанию: не задано > 0

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

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

  • ril.ecclist, когда SIM-карта не установлена.
  • ril.ecclistSimSlotNumber, когда вставлена SIM-карта, и SimSlotNumber – идентификатор слота абонента по умолчанию.

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

Проверка

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

adb shell settings put global emergency_affordance_number NUMBER_TO_CALL

Хотя этот параметр можно задать в обычной сборке для пользователей, он игнорируется. Чтобы позвонить, номер должен быть в списке номеров экстренных служб, предоставленном RIL. Это можно временно настроить с помощью следующей команды, выполненной из корневой оболочки на устройстве userdebug:

setprop ril.ecclist "$(getprop ril.ecclist),NUMBER_TO_CALL"

Следующая команда позволяет принудительно включить функцию Emergency Affordance, даже если не обнаружена индийская мобильная сеть или не вставлена индийская SIM-карта.

adb shell settings put global force_emergency_affordance 1

Рекомендуем протестировать как минимум следующие сценарии:

  • Если эта функция включена, при длительном нажатии кнопки Экстренный вызов на заблокированном экране (рис. 1) будет выполнен вызов на указанный номер экстренной службы.
  • Если эта функция включена, в меню глобальных действий появится пункт Экстренный вызов. При нажатии на него будет выполнен вызов на указанный номер экстренной службы.
  • Функция не активируется, если не обнаружена индийская мобильная сеть с установленной SIM-картой, выпущенной не в Индии.
  • Функция активируется на устройстве, если в него вставлена индийская SIM-карта, независимо от обнаруженных мобильных сетей.
  • Функция активируется на устройстве, если оно подключено к индийской мобильной сети, независимо от того, какие SIM-карты в нем установлены.

Если устройство поддерживает несколько SIM-карт, необходимо проверить, правильно ли определяется код страны оператора мобильной связи (MCC) в каждом слоте. Функция Emergency Affordance не регулируется набором тестов на совместимость с Android (CTS), поэтому для нее нет тестов CTS.

Часто задаваемые вопросы

В. В Индии номер экстренной службы 112 ещё не введен в эксплуатацию. Стоит ли его использовать?

112 – номер, который используется в Индии в качестве единой дежурно-диспетчерской службы (ЕДДС), как определено в интегрированных системах экстренной связи и реагирования (IECRS). Пока центр обработки вызовов экстренных служб не будет введен в эксплуатацию, все звонки на номер 112 будут переадресовываться на существующий номер экстренной службы 100 (хотя это ответственность оператора, а не Android).

В. А как насчет других триггеров, например тройного нажатия кнопки питания?

Производители устройств могут добавлять дополнительные триггеры. Однако, несмотря на то что Министерство связи и информационных технологий Индии одобрило тройное нажатие кнопки питания, этот триггер не поддерживается в эталонной реализации AOSP, поскольку некоторые широко используемые приложения (например, приложение"Камера") используют жесты с кнопкой питания, которые включают многократное нажатие кнопки питания. Такие приложения могут мешать работе функции экстренного вызова, а пользователь может случайно нажать кнопку паники, пытаясь выполнить в них другие действия.