Понимание временной шкалы Pebble Watch

Анатомия булавки

Все выводы записаны в формате JSON и передаются на сервер Pebble через HTTPS.

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

{ "id": "xxxxxxxxx", "time": "2015-05-25T08:42:00Z", "layout": { "type": "genericPin", "title": "You left your house", "tinyIcon": "system://images/NOTIFICATION_FLAG" } } 

1. id представляет собой случайную уникальную строку для каждого события и позволяет эмитенту обновлять и удалять пин-код.
2. time определяет, где на временной шкале оно должно появиться.
3. layout содержит информацию, которая будет отображаться на экране.
4. type определяет, должен ли пин-код быть отформатирован как общее событие, календарь, спорт, погода и т. Д.
5. title — это текст, отображаемый на экране.
6. tinyIcon из списка разрешенных значков.

Получение ключа API

Pebble требует, чтобы у вас было существующее приложение Pebble, загруженное в Pebble App Store , чтобы перенести контакты на сервер Pebble. Приложение на самом деле не нужно ничего делать.

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

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

Дополнительную помощь смотрите в этой статье о том, как отправить приложение Pebble в App Store .

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

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

Прикрепление булавки к серверу Пеббл

Пины можно перенести с вашего собственного сервера на сервер Pebble или из приложения, установленного на устройстве Pebble, на сервер Pebble. Это делается через HTTPS, который широко поддерживается открытым протоколом.

Вот пример передачи пинов с вашего сервера всем пользователям (для иллюстрации используется XMLHttpRequest ):

 var xhr = new XMLHttpRequest(); xhr.open( "PUT", "https://timeline-api.getpebble.com/v1/user/pins/kennedytown-1395203", true ); xhr.setRequestHeader("Content-Type", "application/json"); xhr.setRequestHeader("X-API-Key", "fbbd2e4c5a8e1dbef2b00b97bf83bdc9"); xhr.send(JSON.stringify( { "id": "kennedytown-1395203", "time": "2015-05-25T08:42:00Z", "layout": { "type": "genericPin", "title": "Last train at 11:40 PM out of Kennedy Town", "tinyIcon": "system://images/SCHEDULED_EVENT" } } )); 

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

В этом примере мы выдвигаем булавки из вашего приложения к текущему пользователю:

 Pebble.getTimelineToken( function (userToken) { var xhr = new XMLHttpRequest(); xhr.open( "PUT", "https://timeline-api.getpebble.com/v1/user/pins/kennedytown-1395203", true ); xhr.setRequestHeader("Content-Type", "application/json"); xhr.setRequestHeader("X-User-Token", userToken); xhr.send(JSON.stringify( { "id": "kennedytown-1395203", "time": "2015-05-25T08:42:00Z", "layout": { "type": "genericPin", "title": "Last train at 11:40 PM out of Kennedy Town", "tinyIcon": "system://images/SCHEDULED_EVENT" } } )); }, function (error) {} ); 

После того, как запрос сделан на сервер Pebble, просто откиньтесь на спинку кресла и расслабьтесь и подождите, пока устройство Pebble обновит себя и поместит пин-код в шкалу времени.

 { "id": "uidxxxxxxxxx", "time": "2015-05-25T08:42:00Z", "layout": { "type": "genericPin", "title": "You left your house", "tinyIcon": "system://images/NOTIFICATION_FLAG" }, createNotification: { "layout": { "type": "genericPin", "title": "You JUST left your house", "tinyIcon": "system://images/GENERIC_CONFIRMATION" } } } 

 { "id": "uidxxxxxxxxx", "time": "2015-05-25T08:42:00Z", "layout": { "type": "genericPin", "title": "You left your house", "tinyIcon": "system://images/NOTIFICATION_FLAG" }, updateNotification: { "time": "2015-05-25T08:59:00Z", "layout": { "type": "genericPin", "title": "The time you left your house has changed, how weird", "tinyIcon": "system://images/GENERIC_CONFIRMATION" } } } 

 { "id": "uidxxxxxxxxx", "time": "2015-05-25T08:42:00Z", "layout": { "type": "genericPin", "title": "You left your house", "tinyIcon": "system://images/NOTIFICATION_FLAG" }, actions: [ { "title": "Activate house alarm", "type": "openWatchApp", "launchCode": 15 }, { "title": "Deactivate house alarm", "type": "openWatchApp", "launchCode": 22 } ] }