Как использовать новый Dictation API от Pebble

 static void click_config_provider(void *context) { window_single_click_subscribe(BUTTON_ID_SELECT, select_click_handler); } 

Наша select_click_handler() имеет только одну задачу — начать наш сеанс dictation_session_start() с помощью dictation_session_start() :

 static void select_click_handler(ClickRecognizerRef recognizer, void *context) { dictation_session_start(s_dictation_session); } 

Когда наш сеанс диктовки закончен, и пользователь передал нам свое сообщение через микрофон, мы сказали Pebble запустить dictation_session_callback() . В этой функции мы начинаем с проверки, была ли диктовка успешной. API предоставляет это нам через переменную DictationSessionStatus status :

 static void dictation_session_callback(DictationSession *session, DictationSessionStatus status, char *transcription, void *context) { if(status == DictationSessionStatusSuccess) { // Dictation worked! } else { // Dictation failed 🙁 } } 

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

 snprintf(display_message, sizeof(display_message), "Message sent!\n\n\"%s\"", transcription); text_layer_set_text(message_layer, display_message); handle_message(transcription); 

Если есть ошибка, мы отображаем код сообщения об ошибке на экране вместо транскрипции:

 static char error_message[128]; snprintf(error_message, sizeof(error_message), "Error code:\n%d", (int)status); text_layer_set_text(message_layer, error_message); 

Передача сообщений в JavaScript

Функция handle_message мы использовали ранее, принимает сообщение и помещает его в словарь нашего приложения. Это позволяет нам отправлять эти данные в код JavaScript с помощью функции Pebble AppMessage. Мы app_message_outbox_begin() доступ к словарю через DictionaryIterator а затем открываем наш почтовый ящик, готовый отправить сообщение в наш JavaScript, используя app_message_outbox_begin() . У нас есть только один ключ в нашем словаре для этого приложения, в котором хранится сообщение диктовки, поэтому, когда мы записываем в наш словарь, мы записываем сообщение в позицию 0 в dict_write_cstring() . Как только сообщение сохранено в этом ключе, мы отправляем его через app_message_outbox_send() .

 static void handle_message(char *slack_message) { DictionaryIterator *iter; app_message_outbox_begin(&iter); dict_write_cstring(iter, 0, slack_message); app_message_outbox_send(); } 

Остальная часть кода на C довольно понятна для всех, кто раньше работал над разработкой приложений для Pebble, поэтому мы продолжим работу с JavaScript!

Наш код JavaScript

Часть JavaScript в уравнении немного короче и выглядит так:

 var host = "https://maker.ifttt.com/trigger/", key = "PUTYOURKEYHERE"; function send_message(message) { console.log(host + "slack_message/with/key/" + key); var url = host + "slack_message/with/key/" + key, data = {"value1": message}; sendPOSTRequest(url, data, function() { console.log("Error!"); }); } function sendPOSTRequest(url, data, fallback) { var req = new XMLHttpRequest(); req.onreadystatechange = function(e) { if (req.readyState == 4 && req.status == 200) { var response = JSON.parse(req.responseText); console.log("Response was ", response); if (response !== undefined && !response.error) { console.log("Message sent successfully."); } else { console.log(response.error); if (fallback) fallback(); } } else if (req.status == 404 || req.status == 500) { console.log("Error " + req.status); if (fallback) fallback(); } }; req.open("POST", url); req.setRequestHeader("Content-Type", "application/json"); req.send(JSON.stringify(data)); } Pebble.addEventListener("appmessage", function(e) { var message = e.payload["0"]; console.log("Received message: " + message); send_message(message); }); 

Начало JavaScript устанавливает начальные настройки URL для URL, который мы хотим вызвать из IFTTT. Этот вызов должен быть в формате https://maker.ifttt.com/trigger/{event}/with/key/{yourkey} . Мы храним начальную часть URL в host а ваш ключ — в key . Вы можете найти свой ключ на странице IFTTT канала Maker . Остальное будет настроено в следующей функции.

 var host = "https://maker.ifttt.com/trigger/", key = "PUTYOURKEYHERE"; 

Функция, которую мы будем вызывать, когда мы хотим отправить сообщение в IFTTT, получила соответствующее имя send_message() . Это помещает наши переменные host и key в наш IFTTT URL вместе с нашим именем события slack_message . Переменная data содержит объект JSON с ключом "value1" который IFTTT ищет, когда решает, как ответить на запрос POST. Если вы хотите передать больше значений, вы также можете передать value2 и value3 .

 function send_message(message) { console.log(host + "slack_message/with/key/" + key); var url = host + "slack_message/with/key/" + key, data = {"value1": message}; ... 

Затем в нашей функции мы передаем этот url и data в функцию sendPOSTRequest() которая будет выполнять магию HTTP-запроса. Он имеет функцию обратного вызова с ошибкой, которая будет запускаться, если что-то пойдет не так (в этом случае мы просто запишем это на консоль).

 sendPOSTRequest(url, data, function() { console.log("Error!"); }); } 

Функция sendPOSTRequest() использует типичный формат JavaScript XMLHttpRequest . Это будет очень похоже на любые запросы POST, содержащие данные JSON. Объяснение деталей того, как это работает, выходит за рамки данной статьи, но довольно распространено в Интернете:

 function sendPOSTRequest(url, data, fallback) { var req = new XMLHttpRequest(); req.onreadystatechange = function(e) { if (req.readyState == 4 && req.status == 200) { var response = JSON.parse(req.responseText); console.log("Response was ", response); if (response !== undefined && !response.error) { console.log("Message sent successfully."); } else { console.log(response.error); if (fallback) fallback(); } } else if (req.status == 404 || req.status == 500) { console.log("Error " + req.status); if (fallback) fallback(); } }; req.open("POST", url); req.setRequestHeader("Content-Type", "application/json"); req.send(JSON.stringify(data)); } 

Наконец, у нас есть фрагмент кода, который запускает наше сообщение. Мы слушаем событие appmessage которое вызывается app_message_outbox_send() в нашем C-коде. Когда это приложение обнаруживает его, оно отправляет данные в формате {"0": "yourmessage"} . Мы фокусируемся на ключе "0" и отправляем его в нашу send_message() .

 Pebble.addEventListener("appmessage", function(e) { var message = e.payload["0"]; console.log("Received message: " + message); send_message(message); }); 

Запуск нашего приложения

Лучше всего запускать приложение на реальных часах Pebble Time. Вы также можете использовать команды Pebble API в терминале для работы с эмулятором через SDK, однако я обнаружил, что гораздо проще просто поговорить с моим Pebble напрямую через CloudPebble! Главное, что нужно иметь в виду при создании приложения, это убедиться, что «Build Aplite» не отмечен в настройках вашего проекта. Наша демонстрационная программа не будет работать с платформой Aplite (это первая платформа Pebble watchface). Ваши настройки должны выглядеть так: