Взаимодействия Хэндофф

Передача пользовательского действия включает три фазы:

• Создайте пользовательский объект действия для каждого действия, которое пользователь вовлекает в Ваше приложение.

• Обновляйте пользовательский объект действия регулярно с информацией о том, что делает пользователь.

• Продолжайте пользовательское действие на различном устройстве, когда пользователь запросит его.

Основанные на документе приложения (т.е. приложения на основе подкласса NSDocument или UIDocument), предоставьте встроенную поддержку для всех трех фаз handoff сценария. Респондент возражает (подклассы NSResponder и UIResponder) предоставьте встроенную поддержку для обновления пользовательских действий и управления их текущим статусом. Ваше приложение может также создать, обновить и продолжать пользовательские действия непосредственно, работая особенно с делегатом приложения.

Механизм Хэндофф зависит прежде всего от объектов единого класса в Основе, NSUserActivity, с поддержкой дополнительного маленького APIs в UIKit и AppKit. Приложения инкапсулируют информацию о действиях пользователя в NSUserActivity объекты и те действия становятся кандидатами на продолжение на других устройствах. Хэндофф данного пользовательского действия требует, чтобы исходное приложение определяло что действие NSUserActivity возразите как текущее действие, сохраните подходящие данные для продолжения на другом устройстве и отправьте данные в возобновляющееся устройство. В то время как синхронизация данных более широкого масштаба обрабатывается через iCloud, Хэндофф передает только достаточно информации между устройствами для описания самого действия.

На продолжающемся устройстве пользователь уведомляется, что действие доступно для продолжения. Если пользователь принимает решение продолжать действие, надлежащее приложение запускается и предоставлено данными полезной нагрузки действия. Пользовательское действие может продолжаться только в приложении, имеющем ту же Команду разработчика ID как исходное приложение действия, и это поддерживает тип действия. Поддерживаемые типы действия указаны в приложении Info.plist под NSUserActivityTypes ключ. Так, продолжающееся устройство выбирает надлежащее приложение на основе целевой Команды ID, свойство типа действия возникновения NSUserActivity объект, и дополнительно свойство заголовка объекта действия. От информации в пользовательском объекте действия userInfo словарь, продолжающееся приложение может тогда сконфигурировать свой пользовательский интерфейс и утвердить соответственно для бесшовного продолжения действия пользователя.

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

Основанные на документе приложения на iOS и OS X автоматически поддерживают Хэндофф, как описано в Поддержке Пользовательского Действия в Основанных на документе Приложениях.

Пользовательский объект действия

NSUserActivity объект инкапсулирует состояние пользовательского действия в приложении на определенном устройстве. Это - основной объект в механизме Хэндофф. Исходное приложение создает пользовательский объект действия для каждого пользовательского действия, которое оно поддерживает для возможного handoff к другому устройству. Например, веб-браузер создал бы пользовательский объект действия для каждой открытой вкладки или окна, в котором пользователь просматривает URLs. Однако только соответствие объекта действия вкладке frontmost или окну является текущим в установленный срок, и только текущее действие доступно для продолжения.

NSUserActivity объект идентифицируется activityType и title свойства. Это имеет a userInfo словарь для содержания его данных состояния и грязного названного флага needsSave поддерживать ленивое обновление его состояния его делегатом. NSUserActivity метод addUserInfoEntriesFromDictionary: позволяет делегату и другим клиентам объединить данные состояния в userInfo словарь.

Для получения дополнительной информации посмотрите Ссылку класса NSUserActivity.

Пользовательский делегат действия

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

Пользовательский делегат действия представлен delegate свойство NSUserActivity и ответственно за удержание данных NSUserActivity пользовательский информационный словарь объекта, актуальный так, чтобы это могло быть передано к другому устройству. Когда системе нужно действие, которое будет обновлено, такой как, прежде чем действие будет продолжаться на другом устройстве, это вызывает делегата userActivityWillSave: метод. Можно реализовать этот обратный вызов для создания обновлений к переносящим данные свойствам объекта таким как userInfo, title, и т.д. Один раз системные вызовы этот метод, это сбрасывает needsSave к NO. Измените это значение на YES если что-то происходит, который изменяется userInfo или другие переносящие данные свойства снова.

Также вместо того, чтобы реализовать делегата userActivityWillSave: метод, как описано в предыдущем абзаце, у Вас может быть UIKit, или AppKit управляют пользовательским действием автоматически. Приложение выбирает в это поведение путем установки объекта респондента userActivity свойство и реализация респондента updateUserActivityState: обратный вызов, как описано в Управлении Пользовательским Действием С Респондентами. Это расположение предпочтено, если оно работает на Ваше пользовательское действие.

Для получения дополнительной информации посмотрите Ссылку на протокол NSUserActivityDelegate.

Поддержка платформы приложения

UIKit и AppKit предоставляют поддержку для Хэндофф в документе, респондента, и делегата приложения классы. Несмотря на то, что существуют незначительные поведенческие различия между платформами, основной механизм, позволяющий приложениям сохранить и восстановить пользовательские действия, является тем же, и APIs является тем же.