ym88659208ym87991671
Поддержка пульта | Документация для разработчиков

Поддержка пульта

Обновлено 13 сентября 2023

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

Когда пользователь нажимает кнопки на пульте, ОС устройства передает события аналогичные событиям KeyEvent в Android.

Вы можете обрабатывать эти события, например, переопределив колбэк onKeyDown():

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
Log.d("debug", "мы находимся здесь");
switch (keyCode) {
case KeyEvent.KEYCODE_POWER:
case KeyEvent.KEYCODE_VOLUME_MUTE:
case KeyEvent.KEYCODE_DPAD_UP:
case KeyEvent.KEYCODE_DPAD_RIGHT:
case KeyEvent.KEYCODE_DPAD_DOWN:
case KeyEvent.KEYCODE_DPAD_LEFT:
case KeyEvent.KEYCODE_DPAD_CENTER:
case KeyEvent.KEYCODE_BACK:
case KeyEvent.KEYCODE_SEARCH:
case KeyEvent.KEYCODE_HOME:
case KeyEvent.KEYCODE_VOLUME_UP:
case KeyEvent.KEYCODE_VOLUME_DOWN:
Log.d("OnKey", "Кнопка нажата");
Toast.makeText(MainActivity.this, "Кнопка нажата", Toast.LENGTH_SHORT).show();
return true;
}
return false;
}

Виртуальный пульт

Нативные приложения салют поддерживают виртуальный пульт, который:

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

Описание пульта

Пульт дистанционного управления поставляется со следующими умными устройствами:

  • Салют ТВ;
  • SberBox;
  • SberBox Time;
  • SberBox Top.
SberBox

События нажатия кнопок

События нажатия кнопок умных устройств Sber аналогичны событиям нажатия стандартных клавиш клавиатуры Android:

Кнопка на пультеКод нажатия клавиши на клавиатуре Android
Включить/ВыключитьKeyEvent.KEYCODE_POWER = 26
Отключить звукKeyEvent.KEYCODE_VOLUME_MUTE = 164
ВверхKeyEvent.KEYCODE_DPAD_UP = 19
ВправоKeyEvent.KEYCODE_DPAD_RIGHT = 22
ВнизKeyEvent.KEYCODE_DPAD_DOWN = 20
ВлевоKeyEvent.KEYCODE_DPAD_LEFT = 21
ОкKeyEvent.KEYCODE_DPAD_CENTER = 23
НазадKeyEvent.KEYCODE_BACK = 4
Вызов ассистента.
Активирует микрофон
KeyEvent.KEYCODE_SEARCH = 84
ДомойKeyEvent.KEYCODE_HOME = 3
Увеличение громкостиKeyEvent.KEYCODE_VOLUME_UP = 24
Уменьшение громкостиKeyEvent.KEYCODE_VOLUME_DOWN = 25

Рекомендации по поддержке пульта

Активация ассистента

Для использования голосовых команд пользователь активирует ассистента через кнопку Салют на пульте. Это создает дополнительное условие: чтобы пользоваться приложениями, нужно держать пульт в руке.

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

Приоритетная навигация

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

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

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.