Справка для преподавателя

Коротко о том, как устроены «Клавиши»: вы добавляете пьесу и записываете эталон, даёте ученику задание, ученик играет дома на цифровом пианино, приложение оценивает попытку, вы смотрите результат и при необходимости поправляете оценку.

С чего начать

  1. Инструмент — один раз проверьте своё пианино (сдвиг октавы, педаль, сила нажатия).
  2. Библиотека → + Добавить пьесу — название, размер, темп. Ноты загружать не обязательно.
  3. Записать эталон — сыграйте пьесу под метроном. Это образец, с которым сравнивается ученик.
  4. Ученики → + Добавить ученика, отметьте согласие по договору, отправьте ссылку-приглашение.
  5. В карточке ученика — Новое задание.

Библиотека и эталоны

  • Эталон — ваша запись пьесы. Лучше записывать под метроном: тогда приложение знает такты и доли и может задавать фрагменты («такты 5–8») и проверять темп.
  • Эталон без метронома тоже работает, но такты у такой пьесы неизвестны — задавать можно только всю пьесу.
  • Точность под метроном в таблице эталонов — сколько нот легло на сетку. Ниже 80 % — вероятно, метроном считал другие доли; лучше перезаписать.
  • Эталонов у пьесы может быть несколько; сравнение идёт с основным. Кнопка Сделать основным меняет его. Если основной эталон записан под метроном, его **темп и размер становятся темпом и размером пьесы** — с этим темпом по умолчанию назначаются задания (в задании темп можно изменить).
  • Загрузить готовую запись из файла — прежние записи рекордера (.json) или MIDI (.mid): как эталон или как попытку выбранного ученика.
  • Поиск и фильтры над списком — по названию или композитору, виду произведения, классу и наличию нот или эталона (например, «эталон под метроном»).
  • Фрагменты — именованные части пьесы («Начало, такты 1–8»); в форме задания они выбираются одной кнопкой.

Аудио-эталон

  • MIDI-эталон — «технический»: с ним приложение сравнивает игру ученика нота в ноту. Аудио-эталон — живая запись, как пьеса должна звучать; её ученик слушает на странице задания («Как это звучит»).
  • Карточка пьесы → Аудио-эталон: загрузите файл (MP3, M4A, WAV, OGG, FLAC, до 25 МБ) или нажмите ● Записать с микрофона, сыграйте, ■ Стоп, прослушайте и Сохранить. Микрофон ноутбука или телефона рядом с пианино — достаточно; шумоподавление при записи выключено, чтобы не портить звук.
  • Подпись для ученика — кто исполняет: «Святослав Рихтер», «Наталья, урок 12 сентября». Пусто — «Запись преподавателя».
  • Если аудио-эталона нет, ученик слышит образец, сыгранный синтезатором по нотам (MIDI-эталону), в темпе задания и только своих тактов. Аудио-эталон звучит целиком — ученику подписано, какие такты ему нужны.

Ноты

  • MIDI из нотного редактора (MuseScore, Sibelius, Finale), загруженный как эталон, сразу считается «под метроном»: ноты в нём стоят ровно, темп и размер берутся из файла. MIDI, записанный с пианино, — живая игра: если играли под метроном, укажите его темп при загрузке.
  • Без нот всё работает: приложение записывает ноты по вашему основному эталону и показывает их нотным станом (скрипичный и басовый ключ). Это автоматическая запись: длительности упрощены, лиги, штрихи и аппликатура не показываются, знаки при ключе угаданы по звукам.
  • Нотный стан строится только по эталону под метроном. Если эталон записан без метронома, тактов нет — показывается лента (по горизонтали время, цвет — рука).
  • Ленту можно открыть и под нотным станом: «Показать лентой» — видно, как сыграно в эталоне.
  • Ученик видит нотный стан только своего фрагмента — тактов из задания.
  • Если у пьесы есть ноты в электронном виде — MusicXML из MuseScore, Sibelius или Finale («Файл → Экспорт → MusicXML»), — загрузите их в карточке пьесы: «Загрузить нотный текст». Тогда ученик сравнивается с нотами, а не с записью. Скан и PDF не подходят.
  • Убрать ноты — вернуться к сравнению с основным эталоном.

Ученики и приглашения

  • Имя и фамилия вводятся отдельно; список сортируется по фамилии.
  • Фильтр над списком: по умолчанию отключённые ученики скрыты; кнопки показывают активных, учеников с предупреждениями, ждущих приглашения, без согласия, отключённых или всех. Поиск — по имени или логину.
  • Ученик входит по логину и паролю. Пароль он задаёт сам по ссылке-приглашению из карточки (действует 14 дней). Забыл пароль — Новое приглашение.
  • Приглашение можно создать только после отметки о согласии (номер и дата договора).
  • В списке учеников: попытки и минуты за 7 дней, последняя оценка и предупреждения — «срок задания прошёл», «не занимается 3+ дня», «низкая оценка».

Задания

  • Новое задание: пьеса, такты «с — по» (пусто — вся пьеса), руки, темп, срок, комментарий.
  • Стадия меняет, что важнее в итоговой оценке: разбор — правильные ноты, отработка — ноты и ритм, доводка — темп становится так же важен, как ноты и ритм.
  • Кнопки в строке задания:
    • Выполнено — задание убирается со страницы ученика «Сегодня»;
    • В работу — вернуть выполненное задание ученику;
    • Задать снова — создать такое же новое задание (например, после урока), а это отметить выполненным;
    • удалить — задание пропадает, попытки остаются.

Попытки и оценки

  • После каждой попытки ученик сразу видит балл, звёзды, пять оценок и до трёх замечаний.
  • Пять оценок: точность нот, ритм, темп (относительно заданного), непрерывность (остановки, возвраты), синхронность (руки и аккорды вместе).
  • Если совпало мало нот, приложение пишет «похоже, сыграна другая пьеса или другие такты» и остальные оценки не показывает.
  • ▶ Попытка / ▶ Эталон — прослушать; ⏸ — пауза, ⏹ — стоп, полосу можно перетаскивать.
  • Пересчитать — оценить заново (после смены основного эталона или загрузки нот). Оценить попытки без оценки — для записей, сделанных до появления анализа.

Ваша оценка и комментарии

  • Сохранить оценку — если анализ ошибся: критерий, ваша оценка, причина. Ученик увидит «поправил преподаватель» и причину. Пустая оценка отменяет правку.
  • Комментарий ученику — ко всей попытке или к такту; ученик видит его на экране результата.

Сводка к уроку

  • Вверху карточки ученика: что было с прошлого урока — попытки, минуты, дни занятий, лучшая и последняя оценка по заданиям, самые частые замечания.
  • ✓ Урок проведён — отметить урок; следующая сводка начнётся с этого момента.

Программы

  • Меню Программы — программы обучения, их классы и требования классов: гаммы, техника, сколько произведений за год (всего и по видам), формы контроля. Требования видны в карточке ученика, по ним строятся разминка и план на год.
  • Сначала там две типовые программы: ДПОП «Фортепиано» (1–9 класс) и общеразвивающая (1–8). Всё можно менять под свою школу:
    • программа — переименовать, удалить (если по ней никто не учится), создать новую («Новая программа», сразу с нужным числом пустых классов);
    • класс — «+ Добавить класс» в конец (название своё: «Подготовительный», «9 (доп.) год»); ↑ ↓ — порядок классов (по нему работает «Перевести» в карточке ученика); «Изменить» — название и требования; «удалить класс» — если в нём нет учеников;
    • Вернуть типовые — у классов типовых программ, отменяет ваши правки требований.
  • Количество произведений — число или диапазон: `6-10`. Пустое поле — «не важно».
  • Класс ученика выбирается в его анкете («Изменить»): список сгруппирован по программам.

Виды произведений

  • Программы → Виды произведений: полифония, крупная форма, пьеса, этюд, ансамбль, упражнение — и свои (например, «Аккомпанемент», «Чтение с листа»).
  • Вид выбирается у пьесы в библиотеке и у пункта плана на год; в требованиях класса для каждого вида — своё количество.
  • Переименовать можно всегда; убрать — только вид, которым ещё не отмечена ни одна пьеса и ни один пункт плана.

Программа ученика

  • В карточке ученика — его программа и класс (меняются в «Изменить») и требования класса.
  • Перевести: N класс — обычно в конце учебного года: ученик переходит в следующий класс той же программы, требования и разминка сменятся. План на год ведётся по учебным годам — с 1 сентября начинается новый.
  • План занятия на сегодня — то, что ученик видит у себя на странице «Сегодня»:
    1. разминка — строка «Гаммы» из требований класса (около 15 % времени);
    2. прогон программы — если до контрольной точки 7 дней или меньше;
    3. задания — сначала те, где оценка ниже, срок ближе и пьеса нужна к контрольной точке. Время — из поля «Занятия, мин в день». Что не влезло — «если останется время».

План на год

  • Список произведений на учебный год (с 1 сентября). Пьесу можно выбрать из библиотеки или просто написать название — например, если нот и эталона ещё нет.
  • Над списком — сколько произведений каждого вида в плане и сколько нужно по программе класса. Жёлтым — если пока меньше, чем нужно.
  • Состояние ставится само: «в работе» — по пьесе есть задание; «готово» — ученик сыграл всю пьесу двумя руками на 85 и выше. Можно выбрать вручную; «авто» — вернуть автоматическое.

Контрольные точки

  • Технический зачёт, академический концерт, контрольный урок, экзамен, прослушивание, концерт или конкурс — с датой и примечанием.
  • Программа выступления — пьесы (из библиотеки) и пункты текстом, например «гаммы до 2 знаков». Для каждого — состояние, как в плане на год, и «готово N из M».
  • За 7 дней до точки ученик видит в плане «прогон программы», а пьесы из неё поднимаются выше. В списке учеников появляется предупреждение «контрольная точка через N дней».

Отчёт родителю

  • Карточка ученика → Отчёт родителю. Период: неделя, месяц, четверть или свои даты.
  • В отчёте: дни и минуты занятий, календарь, лучшая серия дней подряд, над чем занимались и что стало лучше («было → стало» — средняя оценка по пьесе в начале и в конце периода), готовые пьесы плана, ближайшие контрольные точки, ваш комментарий и цели.
  • Оценок отдельных попыток и «красных» слов в отчёте нет — только динамика.
  • Комментарий собирается автоматически как черновик — поправьте его, добавьте цели и нажмите «Сохранить и получить ссылку». Цифры в сохранённом отчёте больше не меняются.
  • Как отправить:
    • ссылка — родитель открывает без входа, работает 30 дней; её можно отозвать или выдать новую;
    • текст для мессенджера — короткая версия со ссылкой, кнопка «Скопировать текст»;
    • PDF / печать — в окне печати выберите «Сохранить как PDF».
  • Все отчёты — в карточке ученика, раздел «Отчёты родителю».
  • Ученик видит их у себя в Прогресс (вместе с комментарием и целями) — пишите так, чтобы текст подходил и ребёнку. Там же он в любой момент видит свой прогресс за неделю, месяц, четверть.

Вид страницы ученика

В данных ученика — режим интерфейса (меняется в «Изменить»):

  • Юный — «ты», крупно, маскот Клавишка. Результат попытки — звёзды и одна главная задача, подробности по кнопке. Дневная цель «Заполни клавиатуру»: каждое сделанное дело из плана раскрашивает часть октавы, всё сделано — октава раскрашена целиком. За каждый день занятий — стикер в коллекцию.
  • Подросток — «ты», балл и критерии, полоса «цель дня», серия дней подряд.
  • Взрослый — «вы», балл и критерии, минуты за день и выполнение плана, серия дней.
  • Задание считается сделанным за день, если была хотя бы одна попытка; разминку и прогон ученик отмечает сам кнопкой «Сделал(а)».
  • «Может переключать» — ученик сам выбирает вид внизу страницы «Сегодня».
  • Награды — только за занятия, не за баллы; рейтингов между учениками нет.

Без рук и голосом. На странице задания у ученика есть режим Без рук: запись начинается с первой ноты, после 5 секунд тишины отправляется сама, и результат звучит голосом (синтез речи устройства). Самая нижняя клавиша — «начать заново» или «повтори результат», самая верхняя — «послушать себя». В тексте — звёзды (или баллы у «Взрослого»), одно-два главных замечания и ваш комментарий к попытке. Кнопка 🔊 Как слышит ученик на экране попытки — послушать этот текст.

Мой голос для учеников

  • Результат «Юному» и «Подростку» звучит по ролям: вы говорите целые короткие фразы — похвалу, поддержку, общий совет, концовку («Проверь ноты — посмотри в тетрадь ещё раз»); Клавишка (синтезатор, голос повыше) — конкретику: «Клавишка подсказывает: в такте 3 неверные ноты».
  • Ученики → Мой голос для учеников → Записать фразы: около 20 фраз. «● Записать» — сказать — «■ Стоп». Приложение проверяет длину, громкость, перегруз и шум; если что-то не так, подскажет, можно перезаписать или сохранить как есть. «▶» — прослушать, «удалить» — вернуть синтезатор.
  • Записывать можно постепенно: фразы, которых ещё нет, говорит синтезатор.
  • Ученик слышит только своего преподавателя. У «Взрослого» — один синтезированный голос, на «вы».
  • Записи хранятся на сервере вместе с остальными данными и попадают в резервные копии.

Уведомления

  • Внизу страницы Ученики — «Включить уведомления на этом устройстве». Уведомление приходит, когда ученик присылает попытку (с оценкой); нажатие открывает попытку.
  • Включается отдельно на каждом устройстве и браузере: компьютер, телефон. Проверить — пробное уведомление.
  • Ученику приходят: новое задание, ваш комментарий к попытке, новый отчёт и напоминание позаниматься в выбранное им время (если в этот день он ещё не играл).
  • На iPhone и iPad уведомления работают, только если открыть «Клавиши» с главного экрана: в Safari «Поделиться → На экран „Домой“».
  • Почту приложение не использует. Если ученик забыл пароль — создайте новое приглашение.

Телефоны и планшеты

  • Ученик может заниматься с Android-планшета или телефона в Chrome: пианино подключается кабелем через переходник USB-OTG или по Bluetooth MIDI. Инструкция для ученика — в его справке.
  • iPhone и iPad: браузеры на iOS не работают с MIDI. Пока — бесплатное приложение «Web MIDI Browser» (не наше, работает без гарантий); своё приложение для iOS — позже.
  • В записи попытки сохраняется, с какого устройства играли (компьютер / Android / iOS) и задержка звука метронома — это помогает разбираться, если оценка «странная».

Если что-то не так

  • Пианино не находится — кабель USB, пианино включено, страница открыта в Chrome, Edge или Яндекс Браузере; при первом подключении браузер спрашивает разрешение на MIDI — «Разрешить».
  • Странная оценка — послушайте попытку и эталон; проверьте, что основной эталон тот, что нужно, и нажмите Пересчитать. Если оценка всё равно неверна — поправьте её.
  • После обновления приложения что-то выглядит странно — Ctrl+F5.