Регистрация в Apple

Вы обязаны регистрироваться в Сертификатах, разделе Identifiers & Profiles Задействованного Центра для отправки уведомлений нажатия. Регистрация требует лицензии разработчика iOS или лицензии разработчика Mac.

При регистрации включайте следующую информацию:

• Идентификатор. Это - Ваша уникальная обратная строка домена, такой как web.com.example.domain (строка должна запуститься с web.). Это также известно как Нажатие Веб-сайта ID.

• Нажатие веб-сайта Описание ID. Это - имя, используемое всюду по Порталу Настройки для обращения к веб-сайту. Используйте его для своего собственного преимущества для маркировки Нажатия Веб-сайта IDs в более человекочитаемый формат.

Процесс регистрации похож на форму на рисунке 2-1.

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

Создание пакета нажатия

Когда пользователя просят относительно разрешения получить уведомления нажатия, Safari просит у Вашего веб-сервера пакет. Пакет содержит данные, использующиеся уведомлением UI, такой как Ваше имя веб-сайта и значок, а также криптографическая подпись. Подпись проверяет, что Ваше уведомление не было прервано атакой «человек посередине» и что это действительно прибывает из доверяемого источника: Вы.

Вы создаете пакет нажатия первым заполнением папки с определенным набором файлов. Пакет нажатия содержит веб-сайт словарь JSON, ряд значков (называемый iconset), декларация и подпись. Перечисление 2-1 иллюстрирует полную файловую структуру пакета нажатия.

  Файловая структура перечисления 2-1 пакета нажатия

BayAirlines.pushpackage/

    icon.iconset/

        icon_16x16.png

        icon_16x16@2x.png

        icon_32x32.png

        icon_32x32@2x.png

        icon_128x128.png

        icon_128x128@2x.png

    manifest.json

    signature

    website.json

После того, как требуемые файлы существуют, сжимают папку в архив ZIP для создания завершенного пакета нажатия. Пакет нажатия может или быть подан в качестве статического файла или сгенерирован динамично на пользователя (как долго как Content-type соответствия заголовка application/zip). Возвратите пакет нажатия из своего веб-сервера в расположении, которое Вы указываете в Загрузке Вашего Пакета Веб-сайта.

{

    "websiteName": "Bay Airlines",

    "websitePushID": "web.com.example.domain",

    "allowedDomains": ["http://domain.example.com"],

    "urlFormatString": "http://domain.example.com/%@/?flight=%@",

    "authenticationToken": "19f8d7a6e9fb8a7f6d9330dabe",

    "webServiceURL": "https://example.com/push"

}

{

    "website.json": "96838c40594f632cc25d7760fa404c728886b3a8",

    "icon.iconset/icon_16x16.png": "865f103703cbb85e1867793e1c798d96a63417e1",

    ...

}

Запрос разрешения

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

Для проверки разрешения выравниваются, пользователь установил для веб-сайта, вызвать window.safari.pushNotification.permission() с Вашим Нажатием Веб-сайта ID как параметр. Этот синхронный вызов возвращает объект полномочий для данного идентификатора путем взгляда в предпочтениях пользователя. Эта функция не связывается с Вашим сервером.

Объект полномочий содержит ключи, как описано в Таблице 2-2.

Для запроса разрешения отправить пользовательские уведомления нажатия вызвать window.safari.pushNotification.requestPermission(). Запрос разрешения является асинхронным вызовом.

window.safari.pushNotification.requestPermission(url, websitePushID, userInfo, callback);

Описание каждого параметра следующие:

• url— URL веб-сервиса, который должен запуститься с https. Веб-сервер не должен быть тем же доменом как разрешение запроса веб-сайта.

• websitePushID— ID Нажатия Веб-сайта, который должен запуститься с web..

• userInfo— Объект передать серверу. Включите любые данные в этом объекте, помогающем Вам идентифицировать пользователя, запрашивающего разрешение.

• callback— Функция обратного вызова, вызывающаяся на завершение. Обратный вызов должен принять объект полномочий с той же структурой, как описано в Таблице 2-2.

Перечисление 2-3  , Обрабатывающее полномочия для веб-сайта, продвигает уведомления

document.body.onload = function() {

    // Ensure that the user can receive Safari Push Notifications.

    if ('safari' in window && 'pushNotification' in window.safari) {

        var permissionData = window.safari.pushNotification.permission('web.com.example.domain');

        checkRemotePermission(permissionData);

    }

};

var checkRemotePermission = function (permissionData) {

    if (permissionData.permission === 'default') {

        // This is a new web service URL and its validity is unknown.

        window.safari.pushNotification.requestPermission(

            'https://domain.example.com', // The web service URL.

            'web.com.example.domain',     // The Website Push ID.

            {}, // Data that you choose to send to your server to help you identify the user.

            checkRemotePermission         // The callback function.

        );

    }

    else if (permissionData.permission === 'denied') {

        // The user said no.

    }

    else if (permissionData.permission === 'granted') {

        // The web service URL is a valid push provider, and the user said yes.

        // permissionData.deviceToken is now available to use.

    }

};

Конфигурирование конечных точек веб-сервиса

Когда веб-страница запрашивает разрешение вывести на экран уведомления нажатия, Запрос HTTP для Ваших учетных данных отправляется в Ваш веб-сервер. Точно так же, когда пользователь изменяет их настройки уведомлений нажатия веб-сайта в Safari или Установках системы, Запрос HTTP отправляется в Ваш веб-сервер. Необходимо сконфигурировать веб-сервис RESTful на сервере для ответа на эти запросы соответственно. Веб-сервис не должен быть размещен на том же сервере (ах) или домене (ах), служащих Вашим веб-страницам.

Для надлежащей реализации веб-сервиса обработайте конечные точки, как указано в следующих разделах с помощью фрагментов URL, перечисленных в Таблице 2-3.

webServiceURL/version/pushPackages/websitePushID

webServiceURL/version/devices/deviceToken/registrations/websitePushID

webServiceURL/version/devices/deviceToken/registrations/websitePushID

webServiceURL/version/log

Продвижение уведомлений

Вы отправляете уведомления нажатия клиентам таким же образом, что iOS и приложения OS X продвигают уведомления APNs. Как провайдер уведомления нажатия, Вы связываетесь с APNs по двоичному интерфейсу. Это высокая скорость, интерфейс большой емкости использует проект сокета TCP потоковой передачи с двоичным содержанием. Двоичный интерфейс является асинхронным.

Двоичный интерфейс продуктивной среды доступен через gateway.push.apple.com, порт 2195. Не соединяйтесь со средой разработки для отправки Уведомлений Нажатия Safari. Можно установить многократные параллельные соединения с тем же шлюзом или с многократными экземплярами шлюза.

Для каждого интерфейса используйте TLS (или SSL) для установления канала защищенных связей. Сертификат SSL, требуемый для этих соединений, является тем же самым, это настраивается, когда Вы зарегистрировали свое Нажатие Веб-сайта ID в Задействованном Центре. Для установления доверяемых идентификационных данных провайдера представьте этот сертификат APNs во время соединения.

Словарь JSON как тот в Перечислении 2-4 производит уведомление, которое похоже на тот на рисунке 2-3. Объект JSON должен строго соответствовать RFC 4627.

Перечисление 2-4  словарь JSON, показывающий демонстрационную полезную нагрузку уведомления

{

    "aps": {

        "alert": {

            "title": "Flight A998 Now Boarding",

            "body": "Boarding has begun for Flight A998.",

            "action": "View"

        },

        "url-args": ["boarding", "A998"]

    }

}

Наиболее удаленный словарь, идентифицирующийся aps ключ, должен содержать другой названный словарь alert. alert словарь может содержать только ключи, перечисленные в Таблице 2-4. Пользовательские ключи не поддерживаются.

url-args ключ указывает массив значений, соединяющихся с заполнителями в urlFormatString значение Вашего website.json файл. url-args ключ должен быть включен. Число элементов в массиве должно соответствовать число заполнителей в urlFormatString значение и порядок заполнителей в строке Формата ссылки определяют порядок значений, предоставленных url-args массив. Число заполнителей может быть нулем, когда массив должен быть пустым. Однако это - установившаяся практика, чтобы всегда включать по крайней мере один параметр так, чтобы пользователь был направлен к веб-странице, определенной для полученного уведомления.

Для низкоуровневого отказа пакетов уведомления, а также листинга кода того, как отправить уведомление по двоичному интерфейсу, читают Связь Провайдера со Службой Уведомления Нажатия Apple в Локальном и Удаленном Руководстве по программированию Уведомления.

Поиск и устранение неисправностей

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

Также проверьте веб-Инспектора на ошибки, которые могли бы произойти в Вашем JavaScript. Чтобы изучить, как использовать веб-Инспектора, считайте Safari веб-инспектор Гуид.