Skip to content
tim-ecoder edited this page Feb 26, 2023 · 37 revisions

О KeyoneKb2

Latest version: v2.4-build4.6

Инструкция слегка устарела и не учитывает некоторые особенности адаптации под семейство unihertz titan, которые были сделаны в версиях 2.5+

Описание

Клавиатура от фанатов ввода на хардварной клаве и для фанатов ввода на харварной клаве. KeyoneKb2 претендует на то, чтобы быть удобнее, чем Blackberry Keyboard, более настраиваемой и кастомизируемой, чем ruKeyboard. Цель — сделать удобство работы с текстом таким, чтобы не надо было убирать руки с клавиатуры и гладить стекло. Для этого широко применяются разного рода перемещения по тексту и жесты по клавиатуре. Уделяли немалое внимание работе одной рукой, что, например, затруднено в родной «клаве» и каком-нибудь rukeyboard из-за смены языка двумя кнопками. По архитектуре программного кода клавиатура сделана весьма расширяемо и настраиваемо, и может быть адаптирована для других раскладок, устройств и языков. Кроме того, поведение клавиатуры полностью кастомизируется через файлы-настройки json т.е. пользователь может добавлять/удалять/менять хоткеи и многое другое.

Поддерживаемые устройства:

  • Blackberry Key1
  • Blackberry Key2
  • Unihertz Titan Pocket (без жестов по клавиатуре в режиме ввода текста)
  • NEW! Unihertz Titan Slim (без жестов по клавиатуре в режиме ввода текста)
  • Адаптируется без перекомпиляции под любое устройство с аппаратной клавиатурой

Ключевые особенности:

  • Иконка с языком в статус баре, иконка с языком в нижней свайп-панели;
  • Переключение языка одной кнопкой (KEY_0); (Только для Blackberry Key1-2)
  • CTRL+ACXVZ (и даже CTRL+SHIFT+Z) (работает в т.ч. для НЕ_РСТ Blackberry key2: SpeedKey -> CTRL; Unihertz Titan ***: Fn -> CTRL);
  • Жесты по клавиатуре для листания и перемещения курсора по тексту (включительно с жестами вверх-вниз и выделением с SHIFT-ом);
  • Навигационные кнопки (стрелки, pg-up-down, home, end, tab, esc); видимый NAV-pad;
  • SYM-pad для отображения символов из ALT-2 раскладки (которая не гравируется);
  • Много мелких полезностей (ALT+DEL; SHIFT+ENTER; SHIFT+DEL и пр.)
  • Поисковые плагины, которые сами "кликают" на поиск, когда начинаешь вводить текст и возможность их добавлять
  • Тотальная кастомизируемость всего этого под себя через правку json-файлов
  • Возможность менять/добавлять раскладки через правку json-файлов
  • NEW! Режим Указателя для хардкорных блэкберистов с ностальгией

Инструкция для KeyoneKB2 v2.1+

Важно для понимания

  • Для владельцев KEY1. Везде, где указано Ctrl, читать RIGHT_SHIFT;
  • (v2.4+) Для владельцев Unihertz Titan Pocket и Slim. Везде, где указано Ctrl, читать FN; Где указано KEY_0 - этой кнопки попросту нет.
  • (v2.3+) Для владельцев KEY2 НЕ_РСТ. где указано Ctrl, читать SPEED_KEY. Причем, функция SPEED_KEY для вызова приложения будет продолжать работать (Кроме букв ACXVZ и KEY_0);
  • Под Shift везде понимается LEFT_SHIFT;

Чтобы работали наэкранные клавиатуры NAV-pad, SYM-pad и SWYPE-панель, настройка "показывать виртуальную клавиатуру" должна быть включена

А. Переключение языка ввода (раскладки)

  1. KEY_0; ака НОЛЬ (однократное нажатие);
  2. Shift+Space; (пробел при зажатом Shift).

Б. Ввод текста (особенности)

  1. Реализованы сдвоенные символы. Double-click (двойное нажатие) удаляет первый символ и вводит второй (сдвоенный) символ;
  2. Shift+Backspace = Delete (удаляет символ после курсора);
  3. 2xSpace дает сочетание «. » (точка пробел);
  4. В режимах жестов по полям ввода, свайп-панели и NAV-режиме можно делать выделение с зажатием Shift;
  5. (v2.2+) Shift+Enter двигает курсор в начало абзаца (если мы уже в начале абзаца, то в начало предыдущего абзаца);
  6. (v2.2+) ALT+DEL удаляет все до предыдущего начала (перевода) строки (абзац);
  7. (v2.4+) KEY_0+DEL удаляет слово;
  8. (v2.4+) ALT+SPACE делает \t (табуляцию в тексте) в режиме редактирования
  9. (v2.4+) Enter работает как кастомная кнопка (SEARCH, GO, NEXT и пр.), для тех случаев, когда такие опции предлагает хост-приложение (по аналогии как работает BB.Keyboard). Теперь в поиске Wildberries работает нормально.

В. Заглавные буквы

  1. Автоматически становится заглавной первая буква в начале текстового поля, буква после точки и следующего за ней пробела, первая буква в начале новой строки;

Если надо принудительно вернуть строчную букву надо нажать Shift;

  1. Однократное нажатие Shift однократно делает букву заглавной, дальше пойдут строчные;
  2. Shift+Буквы будут заглавными пока зажат Shift;
  3. 2xShift — включение постоянного режима заглавных (caps lock); чтобы выключить caps lock надо однократно нажать Shift;
  4. Если Настройка_5 в состоянии ВЫКЛ, то при удержании буква станет Заглавной. Если буква сдвоенная то: быстрое нажатие; нажатие-с-удержанием;

Г. Ввод ALT-символов

  1. Alt+Key; символ/цифра ALT-раскладки (нанесённой на клавиатуру);
  2. Alt; Key; однократный ввод символа, далее ALT-режим отключается (переходит в буквенный режим); или если включена Настройка_3, то ALT-режим выключится только после нажатия Space;
  3. 2xAlt - включение постоянного режима Alt символов. Выключается нажатием Alt.
  4. Удержание буквы вводит символ из Alt раскладки. Если включена Настройка_5 (если настройка не включена, вводится заглавная буква);

Д. Ввод символов из SYM-раскладки (оно же ALT2 или Alt-Shift)

  1. Во включенном ALT-режиме Shift+Key;
  2. Shift+Удержание;
  3. (v.2.2+) В ALT-режиме (2хALT или зажатый ALT) нажатие с удержанием;
  4. (v.2.2+) В ALT-режиме Быстрое нажатие; нажатие-с-удержанием; дает первый символ из списка доп. символов (п.8) (тире на минусе, рубль на долларе)
  5. Быстрое нажатие; нажатие-с-удержанием; (для работы одной рукой)

Д. Наэкранная SYM-клавиатура

  1. Нажатие Sym открывает/закрывает наэкранную SYM-клавиатуру в режиме Alt2 (sym) раскладки;
  2. Чтобы перевести наэкранную SYM-клавиатуру в ALT-режим (и обратно), надо нажать Alt или Shift;
  3. На некоторых наэкранных символах есть зажатие, тогда появится выбор доп. символов. Например, на символе минус «-» есть вариант «—» тире;

Е. Навигационная клавиатура (NAV-клавиатура) и NAV-режим

  1. Позволяет использовать стрелки вверх/вниз/влево/вправо, HOME, END, PAGE_UP, PAGE_DOWN, ESC, TAB и Shift+Tab;
  2. Можно использовать как в режиме ввода, так и в режиме просмотра для разного рода перемещений по экрану;
  3. «Временный» режим (режим с удержанием/отпусканием). Зажатие SYM+KEY. Отпускание SYM отключает режим;
  4. «Постоянный» режим (в режиме ввода текста открывает NAV-панель. На нее можно нажимать, а можно посмотреть и запомнить буквы на клавиатуре, для использования в режиме зажатия). Включение: 2xSYM. Отключение: Однократное нажатие SYM;
  5. Есть варианты NAV-клавиатуры под правый палец (QYUIO/AHJKL) для постоянного режима и под левый палец (QWERT/ASDFG) для удобства работы с удержанием sym.

Ж. Режимы жестов по клавиатуре (сенсор на клавиатуре)

Жесты по полю ввода (режим Курсора)

  1. «Временный» режим. Зажатие KEY_0 (НОЛЬ) + жест по клавиатуре влево-вправо (если включен режим вертикальных жестов (см. ниже) то и вверх-вниз).

(<=v2.2) Из-за особенности реализации ОС Блекбери. Перед зажатием Нуля, сначала поставить правый палец на клавиатуру (можно начать делать жест). Это все-равно весьма удобно, если попривыкнуть, чтобы допустим вернуться на несколько символов назад, подправить, потом вернуться обратно в место набора;

(v2.3+) Теперь чтобы двигать курсор с зажатие KEY_0 не обязательно сначала ставить палец на клавиатуру, можно сначала зажать KEY_0 потом начать делать жест;

  1. «Постоянный» режим жестов. Включение: (2.4+) 2xKEY_0 (<=2.3 2xCtrl). Выключение: (2.4+) 1xKEY_0 (<=2.3 1xCtrl). Жесты по клавиатуре влево-вправо будут работать до первого ввода текста.
  2. Режим жестов +вверх-вниз (для больших текстов). Включение: (2.4+) 3xKEY_0 (<=2.3 3xCtrl); Отключение: (2.4+) 1xKEY_0 (<=2.3 1xCtrl). Автоматически отключается после ввода первого символа.

Важно (2.4+) 3xKEY_0 (<=2.3 3xCtrl) включает режим вертикальных жестов, после этого этот режим уже будет работать и по (2.4+) 3xKEY_0 (<=2.3 2xCtrl). Пока не будет отключен явно (2.4+) 1xKEY_0 (<=2.3 1xCtrl);

Для Uhihertz Titan Pocket/Slim для активации режима жестов по тексту используется 2xFn (механизм "зашит" в ОС)

(<=v2.3) Хинт Для листания жестами Telegram надо вывалить курсор из поля ввода стрелкой вверх (sym+u/e). (v2.4) Появился Режим перелистывания в режиме редактирования (см. ниже)

  1. (v2.2+) Двойной клик по клавиатуре (без отпускания второго клика - сразу можно начинать делать жест) активирует режим горизонтальных жестов. Отпускание деактивирует режиме жестов по текстовому полю.
  2. (v2.2+) Тройной клик по клавиатуре (без отпускания третьего клика - сразу можно начинать делать жест) активирует режим горизонтальных и вертикальных жестов. Отпускание деактивирует режиме жестов по текстовому полю.

Важно тройной клик включает режим вертикальных жестов, после этого этот режим уже будет работать и по двойному тапу

  1. (v2.3+) В режиме жестов (в т.ч. вертикальных) по полям ввода можно зажимать SHIFT и выделять текст

Режим перелистывания в режиме редактирования

Находясь в диалоге месенджера (допустим, в Telegram) можно по 2xCTRL перейти в режим листания (scroll) истории жестами по клавиатуре. Ввод любого символа отключает этот режим (как в bb.kbd). Раньше надо было "выбить" курсор из поля ввода через NAV-режим (SYM+A);

Жесты по режиму просмотра

  1. Если включена соответствующая настройка (п.9) жесты по просмотру будут работать во всех приложениях (за исключением полей ввода). Включение/отключение: 3xCTRL
  2. Режим пролистывания (scroll) плавно листает страницы через жесты по клавиатуре

(v2.4+) Все что ниже

  1. 2-й режим режим Указатель (Pointer) позволяет перемещать выделение по разным элементам интерфейса, кнопками и пр. (как раньше было в не-touch blackberry)

Так же выделение элементов интерфейса можно перемещать через NAV-режим

  1. Переключить режим (если он включен) можно через 2xCTRL
  2. Выбор текущего варианта режима жестов для приложения переключенная через 2xCTRL запоминается для каждого приложения
  3. Настройка п.9 позволяет выбрать какой режим жестов по режиму просмотра будет работать по умолчанию
  4. Важно. Настройка п.9 не переопределяет уже сохраненные настройки режима жестов для приложений

Иногда не понятно где находится выделенный элемент, для этого надо подвигать указатель сенсором

  1. Для упрощения "нащупывания" пользовательского удобства, где удобно работать указателем, а где нет, есть настройка п.13. Эта настройка дополнительно подсвечивает рамкой выделенный элемент, а так же уставит "фокус", если хост-приложение не поставило фокус само
  2. В режиме указателя можно кликнуть на выделенный элемент через ENTER (и будет стандартное поведение, короткое реализует само хост-приложение), а можно нажать SPACE и тогда будет имитация CLICK (тапа пальцем). В разных приложениях срабатывает по-разному
  3. alt+space делает долгое нажатие в режиме указателя

З. Операции с Ctrl:

  1. Текстовые операции: Ctrl+C (Копировать); Ctrl+V (Вставить); Ctrl+X (Вырезать); Ctrl+A (Выделить все);
  2. Ctrl+Z (Отменить действие); Ctrl+Shift+Z (Отменить отмену т.е. вернуть обратно, если случайно нажал Ctrl+Z).

И. Прочее

(v2.3+) Режим "прозрачности"

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

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

Свайп-панель

  • По этой панели можно делать «свайпы», чтобы перемещать курсор
  • Можно нажимать на стрелки слева и справа, чтобы перемещать курсор «по-одному».
  1. Свайп-панель включается из меню настроек НАСТОЙКА_8 (после переключения клаву надо "передернуть" alt+enter);
  2. Shift+Ctrl включает нижнюю свайп-панель с флажком.

Поисковые плагины

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

  1. В приложениях Blackberry Contacts и Phone (Dialer) можно сразу после входа, не нажимая «лупу», начать набирать на кириллице и будет поиск.
  2. (v2.2+) В Telegram если начать вводить текст в основном окне, будет поиск по чатам.
  3. (v2.3+) Можно добавлять поисковые плагины весьма легко (спец. раздел), например уже добавлен плагин для ExDialer
  4. (v2.3+) К вшитым в приложение плагинам добавлены: Yandex (Maps, Навигатор), Blackberry (Settings, HUB, Notes, Calendar)
  5. (v2.4+) Поисковый плагин активируется теперь на CTRL+ACXV и на DEL и SPACE. Например, вы скопировали адрес, заходите в Яндекс.Карты и не нажимая поиск нажимаете ctrl+v: поиск откроется сам и туда введется адрес из буфера обмена.

(v2.4+) ENSURE_ENTERED_TEXT

В режиме ввода текста, чтобы выйти из приложения (BACK, HOME), если введен какой-то текст, надо нажать дважды (BACK или HOME). Если текст не введен или мы не находимся в поле ввода, то как обычно достаточно нажать один раз. Это важно так как иногда теряется уже введенный текст из за случайного съезда пальца туда вверх (это важно в браузерных полях ввода, где back обнуляет форму ввода). Настройка п.12 для отключения этого режима.

К. Работа со Звонками

Должна быть включена Настройка_6

  1. (v2.2+) Снятие трубки
  • Полезно для К1 (в К2 есть аналогичная функция из коробки)
  • При поступлении звонка
  • Если не в текстовом поле ввода
  • То 2хПробел поднимет трубку
  1. (v2.2+) Положить трубку
  • В режиме разговора или входящего звонка
  • Если не в поле ввода
  • Двоекратное нажатие SYM положит трубку

(v2.3+) Сложные настройки и кастомизации

В отдельной статье https://github.com/tim-ecoder/KeyoneKB/wiki/%D0%A1%D0%BB%D0%BE%D0%B6%D0%BD%D1%8B%D0%B5-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8

БЛАГОДАРНОСТИ

  • Основатель: Артем Твердохлеб aka l3n1n-ua (UA)
  • Соавтор: krab-ubica (RUS)
  • Соавтор: Henry2005 aka CapitanNemo (BY)
Clone this wiki locally