Android application to teach Braille writing system. Inspired by stepik.org, Anki and Braille Tutor

Last update: Dec 9, 2022

Overview

Learn Braille

Learn Braille is an Android application for teaching the tactile writing system created by Louis Braille.

It is one of the few apps primarily designed for the Russian Braille system, but also other systems could be easily added.

The app can be used with Braille Trainer and tiles or without them.

Feel free to contribute!
Take a look at wiki pages (Russian)

User's Guidelines

The app is available in the Google Play.

System Requirements and limitations

To successfully run this application, your smartphone or tablet PC must satisfy the following conditions:

Android 4.4 KitKat or higher (5.1 is required for Google TalkBack optimizations).
Screen of size not less than 4 inches.

For accessibility, you will require TalkBack service. It is pre-installed by default on a majority of devices.
For others, it is available in the Google Play.

Comments

Fix too big toast duration

When user presses "hint" seven times, the toast remains seven times longer on the screen.

This may be inconvenient for sighted.

This and similar issues with toast duration should be solved. At least we should write a wrapper for Toast that will prevent the same toast from being showed multiple times.

See https://stackoverflow.com/questions/10070108/can-i-cancel-previous-toast-when-i-want-to-show-an-other-toast
bug interface

opened by zuevval 6
Investigate 1-star feedback

Answer & try to figure out whether there are still some mistakes left OR maybe this user did not understand the idea of flipped columns

https://play.google.com/store/apps/details?id=com.github.braillesystems.learnbraille&reviewId=gp%3AAOqpTOFoQub8qIRC_VXftkyRaxf4YgyPz2bpDCh0EAddzNPfXWyfCyf4MhnAAqSsYfB8C-MAIxDBeWX9fWYGuw
question feedback

opened by zuevval 5
introduce Greek and Latin symbols
see article, point 11

[x] add caption on top of each symbol in Practice and in Materials Browser

[x] add deck with Greek symbols

[x] add deck with Latin symbols

enhancement practice
opened by zuevval 5
Check Greek symbol map

When I added Greek characters from Golubina's book to AngelinaReader, a user pointed out that it is Soviet mathematical Greek Braille, not modern literary Greek Braille. Therefore, either the symbol map should be changed in our app, or this fact should be mentioned in the lessons and in the browser help.
question lessons

opened by zuevval 4
Checkable dots in hint mode
Dots are checkable after returning from help.

This code does not help:

if (viewModel.state == DotsChecker.State.HINT) { viewModel.expectedDots?.let { dotsState.display(it) } }

The flip button makes them clickable too.
bug accessibility interface
opened by winter-yuki 4
Feature/58 unittests ci
Partially solved #58

moved some tests from androidTest to test, so they may be run without AVD

fixed gradlew (https://stackoverflow.com/a/53943650)

merged dev

added bage to README: (of course it shows FAILING because reflects main repo CI status)

testing
opened by zuevval 4
Release/1.1.0
added materials browser

added user statistics section

fixed mistakes in the course

added more reference to paper book in the course

practice: now one card may not be issued twice in a row
opened by zuevval 4
Investigate 2-star feedback and correct mistakes if any

https://play.google.com/store/apps/details?id=com.github.braillesystems.learnbraille&hl=ru&reviewId=gp%3AAOqpTOHeM0yRzRscXNKSG1m3HQ61IsXXN_dmDLouZ6zlGhgKK0ithZAIZPW_SY1_IOoUPmNNATUOgoIYLHO4Rw

В приложении много ошибок. Буква "Ю" точки 1,2,5,6. Буква "Э" точки 2,4,6. В объяснении буквы "Т" много ошибок. Точки 2,4,5 - буква "Ж", а не "Х". В описании знака препинания "точка" всё верно, но при попытке написать, заставляет писать восклицательный знак (точки 2,3,5), а не литературную точку (точки 2,5,6). Не хватает самых часто используемых знаков препинания. Надо обговорить момент насчёт письма, т.к. на брайлевском приборе написание происходит в зеркальном отражении справа налево.

bug lessons

opened by zuevval 4
CI/CD
[x] static analysis

[x] code style checks

[x] generate KDoc

[x] unit tests

[x] tests on AVD

[ ] ~~deploy developers version from master to google play~~ considered unnecessary

enhancement
opened by winter-yuki 4
Feedback: letters not appearing in Practice section

A user left a review where complained about some letters not appearing in Practice even after having been learnt in Theory.

I've checked it and it is apparently true. Perhaps it's related to new types of lesson steps. I shall check it.
bug practice feedback

opened by zuevval 0
Play Store Data Safety Section
Hi Team

In the recent Play Store policy, it will become mandatory for you to fill out the Data Safety Section. Since this is an OSS Android app, it will make sense to have it as a part of the repository as well.

I have run the scan using my tool here on your repo, attached are the scan results. I found the following:

1 data types

0 SDK.

If this is helpful, do use our free tool to generate Play Store Data Safety report: https://github.com/Privado-Inc/privado

Also, do share your feedback & thanks for the OSS app 😄
opened by vaibhavantil1 0
Prompt user to study or go to settings

VN said that again and again, she is faced with the following situation: a user starts exploring the app, enters Practice, tries it for a while without reading docs or opening other sections, and then concludes that there are only 4 letters in the app.

My idea is to produce a pop-up message or something like that if a user goes to practice and, for example, enters all letters two-three times without having learned a single letter in Theory.
feedback

opened by zuevval 0
New app name?
VN proposes a new title: «учим Брайль»

[x] change Android code

[ ] change iOS code

[x] change Google Play Android description and screenshots

[ ] change Google Play iOS description and screenshots

[ ] change text on VK

[x] change text on the website

interface
opened by zuevval 0
Duplicate type names

https://github.com/braille-systems/learn-braille/blob/382490a519e44d4b0666544f19c185af0f76c87d/app/src/main/java/com/github/braillesystems/learnbraille/res/Materials.kt#L20

https://github.com/braille-systems/learn-braille/blob/382490a519e44d4b0666544f19c185af0f76c87d/app/src/main/java/com/github/braillesystems/learnbraille/data/entities/MaterialData.kt#L24

One or both should be renamed to avoid confusion
refactoring

opened by zuevval 0

Releases(1.3.2)

1.3.2(Feb 7, 2022)

Исправлен раздел "Прочие музыкальные знаки" (благодаря Максиму Озерову)
Source code(tar.gz)
Source code(zip)
1.3.0(Oct 31, 2021)
В этом обновлении:

Название изменено на "Учим Брайль"

Расширен список символов: добавлены ноты и другие музыкальные знаки. В разделе "Символы" можно просмотреть ноты разной длительности и даже прослушать их. В разделе "Обучение" добавлен урок на тему музыкальных знаков.

Введён режим преподавателя, в котором доступны все уроки в курсе, а учёт статистики прохождения не ведётся. Для его активации потребуется четырёхзначный код. Чтобы получить код, отправьте письмо с запросом на [email protected].

В списке символов введена рубрикация по разделам.

В разделе "Уроки" при вводе слов и фраз теперь можно на каждом шаге целиком просмотреть всё вводимое слово.

Прочие мелкие исправления и улучшения.

Обновлённая версия приложения - уже в Google Play
Source code(tar.gz)
Source code(zip)
1.2.1(Oct 19, 2020)

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

Source code(tar.gz)
Source code(zip)
learn_braille_v1_2_1.apk(5.22 MB)
1.2.0(Sep 28, 2020)
Мы долго готовили этот релиз и наконец представляем новую версию, в которой учтены многие пожелания незрячих, работавших с программой.

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

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

Сделаны прочие мелкие исправления и улучшения.

Приложение уже доступно в Google Play, а также Вы можете скачать APK-файл, прикреплённый к этой записи 👇🏼

Рекомендуемый способ установки - через Google Play. При установке этим способом мы гарантируем Вам совместимость версий и сохранность прогресса при каждом обновлении.

Source code(tar.gz)
Source code(zip)
learn-braille_v1_2_0release.apk(5.21 MB)
1.1.0(Aug 1, 2020)
В этом обновлении добавлены элементы, которые, как мы думаем, сделают приложение более интересным для зрячих (например, для родителей учеников с нарушениями зрения), а также исправили некоторые ошибки. Скачивайте наше приложение в Google Play или по ссылке внизу этой записи :arrow_down_small:

Список изменений относительно версии 1.0.2:

новый раздел "символы" - можно посмотреть точечный состав любого символа

введена возможность просмотра статистики использования приложения за последнюю неделю и за месяц

в режиме "практика" раньше иногда выдавались две одинаковые буквы подряд, теперь это исправлено

В разделе "теория":

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

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

Source code(tar.gz)
Source code(zip)
learn-braille_v1_1_0final.apk(5.11 MB)
1.0.2(Jul 15, 2020)
Что изменилось в этом выпуске?

Улучшена доступность для незрячих и слабовидящих:

Боковые кнопки в разделах "практика" и "теория" по умолчанию большого размера, текст в шагах уроков - крупным шрифтом. В настройках это можно изменить переключателем "Режим повышенной доступности"

В уроках заголовки сделаны более понятными при озвучке

Справка по разделам может быть прочитана с помощью TalkBack по абзацам без переключения на режим чтения по словам

изменён текст подсказок при вводе комбинаций точек

Незначительно изменён дизайн.
Source code(tar.gz)
Source code(zip)
learn-braille_v1.0.2.apk(5.07 MB)
1.0(May 22, 2020)
Сегодня мы выпускаем финальную, отшлифованную версию - 1.0.0. Приложение доступно для бесплатного скачивания в Google Play, также можно загрузить APK по ссылке внизу этой записи :arrow_down_small:

Что изменилось по сравнению с версией 0.6?

Дизайн:

изменилось название для русскоязычных пользователей (теперь приложение имеет имя "Азбука Брайля")

изменили иконку приложения

сделали боковые кнопки "назад", "далее" и "подсказка" чуть более узкими, чтобы освободить пространство для текста; текст избавился от излишних отступов сверху и снизу на больших экранах.

Меню переходов между уроками в пошаговом курсе: добавили иконки, которые показывают, открыт урок или ещё недоступен

Добавили новые настройки:

вкл/откл кнопку "выход" в главном меню и кнопку "свернуть это меню" в списке "другие функции" в разделе "теория"

вкл/откл кнопку "сканировать QR-код" (в самом деле, не у всех есть карточки с QR-кодами).

вкл/откл автоматическую озвучку текстов в уроках и справке средствами TalkBack (если выключено, надо сначала сфокусироваться на текстовом поле, и только тогда TalkBack начнёт озвучивать контент).

вкл/откл повторение только пройденных букв в практике

В разделе "Практика" появилась возможность выбрать изучаемую тему ("колоду"): буквы, цифры, специальные символы или всё сразу

исправили мелкие ошибки на Android 5 и 6

Source code(tar.gz)
Source code(zip)
learn-braille_v1.0.0.apk(5.22 MB)
0.6(May 18, 2020)
В новом релизе мы существенно улучшили раздел "Теория" - и не только! Приложение в виде APK - во вложениях внизу :point_down:

Улучшения этой версии:

в разделе "Теория":

теперь заполнены все 26 уроков (русские буквы, цифры и некоторые знаки пунктуации)

появилось меню навигации по курсу

введено меню "Другие функции" (выпадающий список), куда переместилась кнопка перехода к последнему шагу. Отсюда же доступна кнопка "навигация по курсу"

улучшена доступность текста для незрячих: со включённым TalkBack тексты в информационных шагах произносятся вслух; в шагах с выводом и набором символа текстовое поле с символом теперь озвучивается иначе, например, не "прописная буква А", а "введите букву А"

Настройки:

UI соединён с логикой - теперь можно включить/отключить вибрацию, всплывающие уведомления

теперь на устройствах с Android 5.1 и выше можно выбрать порядок обхода точек с помощью TalkBack: сверху вниз и справа налево (1-2-3-4-5-6) или справа налево и сверху вниз (1-4-2-5-3-6)

введена опция проверки буквы "на лету" при вводе: если она включена, пользователю при наборе буквы сразу выдаётся сообщение "правильно", как только он ввёл нужную комбинацию.

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

Source code(tar.gz)
Source code(zip)
learn-braille_v0.6.1.apk(5.02 MB)
0.5(May 4, 2020)
Перед вами усовершенствованная версия приложения LearnBraille - выпуск 0.5.0. apk-файл здесь :arrow_double_down:
Основные изменения:

Для Android 8-10 исправлено перенаправление в Google Play по нажатию кнопки "Сканировать QR-код" в случае, сканер QR-кодов не установлен

Справка по разделам:

теперь при включённом TalkBack справка произносится вслух сразу при заходе в раздел справки, без дополнительных действий со стороны пользователя

исправлены синтаксические ошибки

улучшено форматирование текста (переносы строк и т. д).

расширена справка в разделе "теория"

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

В меню "Выход" добавлена возможность ответа голосом. Для этого в настройках устройства нужно выдать приложению разрешение на запись голоса. Если включён TalkBack, пользователю при выходе задаётся вопрос: "Вы хотите выйти"? Далее (вне зависимости от того, включён TalkBack или нет) можно выйти, сказав "да" или "нет" в микрофон устройства. Требуется соединение с Интернетом.

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

Тренажёр Брайля:

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

В меню "Практика" добавлена реакция на сигнал "вправо" от джойстика тренажёра (реакция - проверка введённого) и "влево" (подсказка)

Source code(tar.gz)
Source code(zip)
learn_braille_v0.5.0.apk(4.70 MB)
0.4.1(Apr 20, 2020)
Мы выпускаем обновление с небольшими исправлениями и улучшениями:

Боковые кнопки в практике и пошаговом курсе теперь имеют разную ширину на разных экранах

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

добавлена озвучка (при включённом TalkBack) выданной буквы в практике и в шагах с вводом символа пошагового курса

в текстах в меню справки и пошагового курса добавлена возможность прокрутки для маленьких экранов.

Source code(tar.gz)
Source code(zip)
learn-braille-v0.4.1beta.apk(4.57 MB)
0.4(Apr 17, 2020)
Мы выпускаем очередную порцию обновлений. Сборка в виде .apk доступна для скачивания, см. приложения ниже :arrow_down_small:

Нововведения коснулись практически всех разделов приложения:

В практике введена кнопка подсказки. По её нажатию точки заполняются правильным образом, но затем ту же букву надо ввести снова.

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

шаги с демонстрацией символов

проверочные шаги с вводом символов

"связующий раствор"- шаги с текстами-пояснениями.

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

Изменён дизайн

подкорректировано расположение и форма элементов на экране

приглушены цвета

иконка справки по разделу изменена на более заметную

в окнах справки текст сделан более читаемым, ключевые слова выделены жирным шрифтом

Исправлена ошибка с остановкой приложения после первого запуска раздела "практика".

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

Мы понимаем, что для чтения важно не только выучить номера точек в азбуке Брайля, но и развить чувствительность пальцев. Поэтому мы продолжаем разрабатывать режим игры с карточками с QR-кодами. Теперь для вас доступен набор карточек в кейсе с тремя отделениями: для неизученных, изучаемых и изученных.

Source code(tar.gz)
Source code(zip)
learn-braille-beta-4-0.apk(4.56 MB)
0.3(Mar 30, 2020)
Сегодня мы выпускаем очередной релиз - Learn Braille v0.3. Как всегда, приложение в виде apk-файла доступно для скачивания, см. ссылку внизу :point_down: :point_down:

Что мы добавили в этот раз:

изменили цветовую палитру приложения

вернули навигационную полосу сверху, причём внесли туда новый функционал:

слева добавили кнопку перехода на уровень вверх

справа добавили кнопку вызова справки по данному разделу. По нажатию кнопки открывается окошко с текстом справки.

Улучшили взаимодействие с TalkBack для удобства незрячих:

при фокусировке на кнопке справки TalkBack произносит: "Кнопка "справка""

каждую точку в шеститочии теперь на слух можно отличить от других: TalkBack произносит вслух её номер от 1 до 6 согласно стандарту.

практика:

ввели счёт правильно решённых заданий

изменили шеститочие так, что оно подстраивается под размер экрана. Теперь приложением удобно пользоваться в том числе и на планшетах с большими экранами.

В разработке находится раздел "пошаговый курс". Он будет включён в один из ближайших релизов. Следите за нашими новостями!
Source code(tar.gz)
Source code(zip)
learnbraille-v0_3.apk(3.80 MB)
0.2(Mar 16, 2020)
В этот раз мы анонсируем сразу две версии приложения. Одну из них - экспериментальную - мы пометили как альфа. Обе версии в виде apk-файлов можно скачать по ссылкам внизу этой записи :point_down:

LearnBraille 0.2: изменения

В разделе Практика:

добавлен вывод русских букв

введённая буква проверяется на корректность. Если правильно, подаётся сигнал (одинарная вибрация и сообщение на экране) и выдаётся следущее задание, иначе - сообщение о том, что введено неверно и вибрация дважды.

Увеличен размер кнопок для ввода брайлевской буквы

В главном меню добавлена кнопка - ссылка на стороннее приложение для сканирования QR-кода на обучающей карточке. Если приложение не установлено, кнопка ведёт на страницу приложения в Google Play.

В диалоговом окне выхода кнопка 'нет' сделана рабочей (возвращает в главное меню)

Убрали панель с заголовком вверху экрана

Добавили оригинальную иконку приложения

Серьёзные изменения произошли под капотом (что никак не должно сказаться на поведении приложения): мы подключили фреймворк Timber и базу данных Room.

LearnBraille Alpha

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

Source code(tar.gz)
Source code(zip)
learnbraille-alpha.apk(3.76 MB)
learnbraille.apk(3.77 MB)