CKNotification

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

CKNotification сам класс является абстрактным классом. Когда Вы создаете новый объект уведомления из словаря полезной нагрузки, notificationFromRemoteNotificationDictionary: метод инстанцирует подкласса надлежащего типа. Точно так же при выборке уведомлений от контейнера что Вы получаете, экземпляры конкретного подкласса. Основа CKNotification класс предоставляет информацию об уведомлении нажатия и как это было поставлено. Определенные подклассы содержат определенные данные, указывающие, какое изменение фактически произошло.

Наследование

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

Оператор импорта

Swift

import CloudKit

Objective C

@import CloudKit;

Доступность

Доступный в OS X v10.10 и позже.

Создание объекта уведомления


    
    init (fromRemoteNotificationDictionary:)
    + notificationFromRemoteNotificationDictionary:

Создает и возвращает новый объект уведомления использование указанных данных полезной нагрузки.

Объявление

Swift

convenience init!(fromRemoteNotificationDictionary notificationDictionary: [NSObject : AnyObject]!)

Objective C

+ (instancetype)notificationFromRemoteNotificationDictionary:(NSDictionary *)notificationDictionary

Параметры


      notificationDictionary

Данные полезной нагрузки для уведомления нажатия. Этот словарь - тот же самый, передал Вашему делегату приложения application:didReceiveRemoteNotification:fetchCompletionHandler: метод. Этот параметр не должен быть nil.

Возвращаемое значение

Новый объект уведомления инициализируется с данными полезной нагрузки.

Обсуждение

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

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.

Идентификация объекта уведомления

notificationID notificationID Свойство

ID уведомления. (только для чтения)

Объявление

Swift

@NSCopying var notificationID: CKNotificationID! { get }

Objective C

@property(nonatomic, readonly, copy) CKNotificationID *notificationID

Обсуждение

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

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.
notificationType notificationType Свойство

Тип события, генерировавшего уведомление. (только для чтения)

Объявление

Swift

var notificationType: CKNotificationType { get }

Objective C

@property(nonatomic, readonly, assign) CKNotificationType notificationType

Обсуждение

Различные типы уведомления соответствуют различным подклассам CKNotification, таким образом, можно использовать значение в этом свойстве, чтобы определить, как обработать данные уведомления.

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.
containerIdentifier containerIdentifier Свойство

ID контейнера, содержание которого инициировало уведомление. (только для чтения)

Объявление

Swift

var containerIdentifier: String! { get }

Objective C

@property(nonatomic, readonly, copy) NSString *containerIdentifier

Обсуждение

Используйте это свойство для определения расположения измененного содержания.

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.

Получение состояния уведомления

isPruned isPruned Свойство
Булево значение, указывающее, было ли некоторое содержание уведомления нажатия удалено до поставки. (только для чтения)

Объявление

Swift

var isPruned: Bool { get }

Objective C

@property(nonatomic, readonly, assign) BOOL isPruned
Обсуждение

Если размер тех данных превышает позволенный максимум, сервер может усечь данные полезной нагрузки уведомления нажатия. Поскольку уведомление возражает созданию использования словаря полезной нагрузки значение этого свойства YEStrue если данные полезной нагрузки не содержат всю информацию, связанную с изменением. Значение NOfalse если данные полезной нагрузки были завершены.

Поскольку уведомление возражает, что Вы выбираете от базы данных с помощью a CKFetchNotificationChangesOperation объект, значение этого свойства всегда YEStrue.

Когда данные полезной нагрузки должны быть отброшены, сервер удаляет данные в определенном порядке. Свойства, определенные этим классом, среди последнего, которое будет отброшено, потому что они определяют информацию о том, как поставить уведомление нажатия. Следующий список показывает свойства этого класса, отбрасывающиеся в порядке, в котором они отбрасываются.
1. containerIdentifier
2. Ключи, определенные подклассами CKNotification
3. soundName
4. alertLaunchImage
5. alertActionLocalizationKey
6. alertBody
7. alertLocalizationArgs
8. alertLocalizationKey
9. значок
10. notificationID
Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.

Доступ к информации уведомления

alertBody alertBody Свойство

Текст предупредительного сообщения. (только для чтения)

Объявление

Swift

var alertBody: String! { get }

Objective C

@property(nonatomic, readonly, copy) NSString *alertBody

Обсуждение

Это свойство содержит нелокализованную версию строки сообщения, выведенной на экран предупреждением.

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.
alertLocalizationKey alertLocalizationKey Свойство

Ключ, идентифицирующий локализованную строку для использования для предупредительного сообщения. (только для чтения)

Объявление

Swift

var alertLocalizationKey: String! { get }

Objective C

@property(nonatomic, readonly, copy) NSString *alertLocalizationKey

Обсуждение

Когда поставлено Вашему приложению, уведомление нажатия получает текст для предупреждения путем поиска указанного ключа приложении Localizable.strings файл. Когда это свойство установлено, значение в alertBody свойство проигнорировано.

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.
alertLocalizationArgs alertLocalizationArgs Свойство

Массив полей раньше создавал предупредительное сообщение (только для чтения)

Объявление

Swift

var alertLocalizationArgs: [AnyObject]! { get }

Objective C

@property(nonatomic, readonly, 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 и позже.
alertActionLocalizationKey alertActionLocalizationKey Свойство

Ключ, идентифицирующий текст для использования для кнопки действий в предупредительной панели. (только для чтения)

Объявление

Swift

var alertActionLocalizationKey: String! { get }

Objective C

@property(nonatomic, readonly, copy) NSString *alertActionLocalizationKey

Обсуждение

Когда это свойство nil, предупредительная панель, инициированная уведомлением нажатия, содержит только кнопку OK для отклонения предупреждения. Когда это свойство не nil, предупредительная панель содержит одну кнопку для отклонения предупреждения и второй кнопки для открытия приложения. Это свойство идентифицирует текст для использования для кнопки для открытия приложения. В частности это содержит имя ключа для поиска в приложении Localizable.strings файл, значение которого используется для заголовка кнопки.

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.
alertLaunchImage alertLaunchImage Свойство

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

Объявление

Swift

var alertLaunchImage: String! { get }

Objective C

@property(nonatomic, readonly, copy) NSString *alertLaunchImage

Обсуждение

Строка в этом свойстве используется для определения местоположения файла образа в комплекте приложений.

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.
soundName soundName Свойство

Имя звукового файла для игры, когда поступает уведомление. (только для чтения)

Объявление

Swift

var soundName: String! { get }

Objective C

@property(nonatomic, readonly, copy) NSString *soundName

Обсуждение

Это свойство содержит строку, используемую для определения местоположения звукового файла в пакете приложения. Когда уведомление нажатия поступает в устройство пользователя, тот звуковой файл играется как предупреждение. Если Вы указываете строку, если указанный звуковой файл не существует, или default для этого свойства система играет предупредительный звук по умолчанию.

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.
значок значок Свойство

Текущее значение значка. (только для чтения)

Объявление

Swift

@NSCopying var badge: NSNumber! { get }

Objective C

@property(nonatomic, readonly, copy) NSNumber *badge

Обсуждение

Значение этого свойства является целочисленным значением, выведенным на экран в значке приложения в то время, когда было отправлено уведомление нажатия.

Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.

Константы

CKNotificationType
Константы, указывающие тип события, генерировавшего уведомление нажатия.

Объявление

Swift

enum CKNotificationType : Int { case Query case RecordZone case ReadNotification }

Objective C

typedef enum CKNotificationType : NSInteger { CKNotificationTypeQuery = 1, CKNotificationTypeRecordZone = 2, CKNotificationTypeReadNotification = 3, } CKNotificationType;

Константы
- Query
  
  CKNotificationTypeQuery
  
  Уведомление, сгенерированное на основе условий, установлено в объекте подписки.
  
  Доступный в OS X v10.10 и позже.
- RecordZone
  
  CKNotificationTypeRecordZone
  
  Когда содержание рекордной зоны изменилось, уведомление генерировало.
  
  Доступный в OS X v10.10 и позже.
- ReadNotification
  
  CKNotificationTypeReadNotification
  
  Уведомление, что Ваше приложение, ранее отмеченное как чтение с помощью a CKMarkNotificationsReadOperation объект.
  
  Доступный в OS X v10.10 и позже.
Оператор импорта

Objective C

@import CloudKit;

Swift

import CloudKit

Доступность

Доступный в OS X v10.10 и позже.