CKNotificationInfo
A CKNotificationInfo
объект указывает данные уведомления нажатия, которые сервер отправляет в Ваше приложение, когда подписка находит соответствие. При конфигурировании a CKSubscription
возразите, создайте один из этих объектов и используйте его для указания типа уведомлений нажатия, которые Вы хотите сгенерированный, когда удовлетворяют триггерному условию подписки. Можно обеспечить сообщение для предупредительной панели, информации о звуках для игры, и информация о том, должно ли приложение быть под маркой. Можно также попросить, чтобы сервер предоставил информацию о записи, инициировавшей уведомление.
При получении уведомления нажатия, сгенерированного подпиской используйте notificationFromRemoteNotificationDictionary:
метод CKNotification
для создания уведомления возражают от данных полезной нагрузки. Тот объект содержит данные, Вы указали использование этого класса при конфигурировании подписки.
Для получения дополнительной информации о предупреждениях уведомления нажатия и как они выведены на экран пользователю, посмотрите Службу Уведомления Нажатия Apple в Локальном и Удаленном Руководстве по программированию Уведомления.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSCopying
-
NSObjectProtocol
-
NSSecureCoding
-
Печатаемый
-
NSCopying
-
NSObject
-
NSSecureCoding
Оператор импорта
Swift
import CloudKit
Objective C
@import CloudKit;
Доступность
Доступный в OS X v10.10 и позже.
-
Текст для использования для предупредительного сообщения.
Обсуждение
Использование этого свойства является дополнительным. При установке его значения соответствующее уведомление нажатия заставляет устройство отображать предупреждение с указанным сообщением. Если Вы хотите использовать локализованную строку для предупредительного сообщения, укажите значение для
alertLocalizationKey
свойство вместо этого.Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.
-
alertLocalizationKey alertLocalizationKey
СвойствоКлюч, идентифицирующий локализованную строку для использования для предупредительного сообщения.
Объявление
Swift
var alertLocalizationKey: String!
Objective C
@property(nonatomic, copy) NSString *alertLocalizationKey
Обсуждение
Использование этого свойства является дополнительным. При установке его значения соответствующее уведомление нажатия заставляет устройство отображать предупреждение на устройстве пользователя. Уведомление нажатия получает текст для предупреждения путем поиска указанного ключа приложении
Localizable.strings
файл. Если Вы указываете значение для этого свойства, значение вalertBody
свойство проигнорировано.Для получения информации о локализации строковых ресурсов посмотрите Руководство по Интернационализации и Локализации.
Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.
-
Массив полей для использования при создании предупредительного сообщения.
Объявление
Swift
var alertLocalizationArgs: [AnyObject]!
Objective C
@property(nonatomic, copy) NSArray *alertLocalizationArgs
Обсуждение
Использование этого свойства является дополнительным. Это свойство содержит массив
NSString
объекты, каждый из которых соответствует полю записи, инициировавшей уведомление нажатия. Те имена используются для получения соответствующих значений от записи. Значения тогда используются для замены любых переменных замены в любомalertBody
илиalertLocalizationKey
строки. Сами значения должны бытьNSString
,NSNumber
, илиNSDate
объекты. Не указывайте ключи с другими значениями. Строковые значения, которые больше, чем 100 символов в длине, могут быть усеченными, когда добавлено к уведомлению нажатия.Если Вы используете
%@
для Ваших переменных замены те переменные заменяются путем обхода массива в порядке. Если Вы используете переменные формы%n$@
, гдеn
целое число,n
представляет индекс (запускающийся в 1) элемента в массиве для использования. Таким образом первый элемент в массиве заменяет переменную%1$@
, второй элемент заменяет переменную%2$@
, и т.д. Можно использовать индексированные переменные замены для изменения порядка пунктов в получившей строке, которая могла бы быть необходимой, когда Вы локализуете сообщения своего приложения.Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.
-
Ключ, идентифицирующий текст для использования для кнопки действий в предупредительной панели.
Объявление
Swift
var alertActionLocalizationKey: String!
Objective C
@property(nonatomic, copy) NSString *alertActionLocalizationKey
Обсуждение
Это свойство идентифицирует текст для использования для кнопки для открытия приложения. В частности это содержит имя ключа для поиска в приложении
Localizable.strings
файл, значение которого используется для заголовка кнопки.Указание значения для этого свойства является дополнительным. Когда его значение
nil
, предупредительная панель, инициированная уведомлением нажатия, содержит только кнопку OK для отклонения предупреждения. Когда его значение неnil
, предупредительная панель содержит одну кнопку для отклонения предупреждения и второй кнопки для открытия приложения.Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.
-
alertLaunchImage alertLaunchImage
СвойствоИмя файла изображения для использования в качестве изображения запуска.
Объявление
Swift
var alertLaunchImage: String!
Objective C
@property(nonatomic, copy) NSString *alertLaunchImage
Обсуждение
Использование этого свойства является дополнительным. При указании значения строка используется для определения местоположения файла образа в комплекте приложений. Когда пользователь запускает приложение после получения уведомления нажатия, то изображение выведено на экран как изображение запуска.
Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.
-
Имя звукового файла для игры, когда поступает уведомление.
Обсуждение
Использование этого свойства является дополнительным. При указании значения строка используется для определения местоположения звукового файла в комплекте приложений. Когда уведомление нажатия поступает в устройство пользователя, тот звуковой файл играется как предупреждение. Если Вы указываете строку, если указанный звуковой файл не существует, или
default
для этого свойства система играет предупредительный звук по умолчанию.Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.
-
shouldBadge shouldBadge
СвойствоБулевская переменная, устанавливающая, который управляет, должно ли быть постепенно увеличено значение значка.
Объявление
Swift
var shouldBadge: Bool
Objective C
@property(nonatomic, assign) BOOL shouldBadge
Обсуждение
Значение по умолчанию этого свойства
NO
false
. Установка его кYES
true
заставляет систему постепенно увеличиваться, текущий значок значат приложение каждый раз, когда поставлено соответствующее уведомление нажатия.Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.
-
Булево значение, указывающее, должно ли уведомление нажатия включать
content-available
флаг.Объявление
Swift
var shouldSendContentAvailable: Bool
Objective C
@property(nonatomic, assign) BOOL shouldSendContentAvailable
Обсуждение
Когда это свойство
YES
true
, сервер включаетcontent-available
флаг в полезной нагрузке уведомления нажатия. Тот флаг заставляет систему будить или запускать в настоящее время не работающее приложение. Приложению тогда дают фоновое время выполнения для загрузки любых данных, связанных с уведомлением нажатия, таким как набор изменившихся записей. Если приложение уже работает на переднем плане, включение этого флага не имеет никакого дополнительного эффекта, и уведомление поставлено делегату приложения к обработке, как обычно.Значение по умолчанию этого свойства
NO
false
.Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.
-
desiredKeys desiredKeys
СвойствоИмена полей для включения в полезную нагрузку уведомления нажатия.
Объявление
Swift
var desiredKeys: [AnyObject]!
Objective C
@property(nonatomic, copy) NSArray *desiredKeys
Обсуждение
Это свойство содержит массив
NSString
объекты, каждый из которых соответствует имени поля в записи, инициировавшей уведомление. Когда уведомление нажатия поставлено, ключи и их соответствующие значения включены в полезную нагрузку уведомления нажатия. Можно включать максимум трех ключей в массиве.Для ключей Вы указываете, допустимые значения
NSString
,NSNumber
,CLLocation
,NSDate
, иCKReference
. Вы не можете указать ключи, значения которых содержат другие типы данных. Строковые значения, которые больше, чем 100 символов в длине, могут быть усеченными, когда добавлено к уведомлению нажатия.Оператор импорта
Objective C
@import CloudKit;
Swift
import CloudKit
Доступность
Доступный в OS X v10.10 и позже.