IMServiceApplication

Плагин службы связывается с клиентом мгновенного обмена сообщениями, использующим IMServiceApplication протокол. Объект, реализовывая этот протокол передается Вашему плагину службы initWithServiceApplication: метод.

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

Не применимый

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

NSObjectProtocol
NSObject

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

Swift

import IMServicePlugIn

Objective C

@import IMServicePlugIn;

Доступность

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

Связь с клиентом мгновенного обмена сообщениями

plugInDidFailToAuthenticate () - plugInDidFailToAuthenticate Требуемый

Указывает, что сеансу не удалось аутентифицировать с мгновенной службой сообщений. (требуемый)

Объявление

Swift

func plugInDidFailToAuthenticate()

Objective C

- (oneway void)plugInDidFailToAuthenticate

Обсуждение

Клиент мгновенного обмена сообщениями повторно запрашивает имя пользователя и пароль и любой вызовы IMServicePlugIn updateAccountSettings: метод с новыми настройками или, если пользователь отменяет, вызывает IMServicePlugIn logout метод.

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

Objective C

@import IMServicePlugIn;

Swift

import IMServicePlugIn

Доступность

Доступный в OS X v10.7 и позже.
plugInDidLogIn () - plugInDidLogIn Требуемый

Указывает, что сеанс вошел в систему. (требуемый)

Объявление

Swift

func plugInDidLogIn()

Objective C

- (oneway void)plugInDidLogIn

Обсуждение

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

Objective C

@import IMServicePlugIn;

Swift

import IMServicePlugIn

Доступность

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


    
    plugInDidLogOutWithError (_: переподключение:)
    - plugInDidLogOutWithError:reconnect:

Требуемый

Указывает, что сеанс вышел из системы. (требуемый)

Объявление

Swift

func plugInDidLogOutWithError(_ error: NSError!, reconnect reconnect: Bool)

Objective C

- (oneway void)plugInDidLogOutWithError:(NSError *)error reconnect:(BOOL)reconnect

Параметры

`error`	Ошибка, если таковые имеются, который вызвал разъединение. Если этот метод вызывают в ответ на `IMServicePlugIn` `logout` вызываемый метод, `error` должен быть `nil`.
`reconnect`	Булево значение, указывающее, должен ли клиент мгновенного обмена сообщениями попытаться повторно соединиться.

Обсуждение

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

Objective C

@import IMServicePlugIn;

Swift

import IMServicePlugIn

Доступность

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


    
    plugInDidUpdateProperties (_: ofHandle:)
    - plugInDidUpdateProperties:ofHandle:

Требуемый

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

Объявление

Swift

func plugInDidUpdateProperties(_ changes: [NSObject : AnyObject]!, ofHandle handle: String!)

Objective C

- (oneway void)plugInDidUpdateProperties:(NSDictionary *)changes ofHandle:(NSString *)handle

Параметры

`changes`	Словарь новых свойств дескриптора для дескриптора. Для списка ключей посмотрите Свойства Дескриптора.
`handle`	Дескриптор.

Обсуждение

Этот метод нужно также вызвать один раз для каждого дескриптора в обновленном списке группы после plugInDidUpdateGroupList:error: метод вызывают.

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

Objective C

@import IMServicePlugIn;

Swift

import IMServicePlugIn

Доступность

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

Константы

Свойства дескриптора
Ключи, используемые в словаре, передали plugInDidUpdateProperties:ofHandle: метод.

Объявление

Swift

let IMHandlePropertyAvailability: NSString! let IMHandlePropertyStatusMessage: NSString! let IMHandlePropertyAuthorizationStatus: NSString! let IMHandlePropertyIdleDate: NSString! let IMHandlePropertyAlias: NSString! let IMHandlePropertyFirstName: NSString! let IMHandlePropertyLastName: NSString! let IMHandlePropertyEmailAddress: NSString! let IMHandlePropertyPictureIdentifier: NSString! let IMHandlePropertyPictureData: NSString! let IMHandlePropertyCapabilities: NSString!

Objective C

NSString * const IMHandlePropertyAvailability; NSString * const IMHandlePropertyStatusMessage; NSString * const IMHandlePropertyAuthorizationStatus; NSString * const IMHandlePropertyIdleDate; NSString * const IMHandlePropertyAlias; NSString * const IMHandlePropertyFirstName; NSString * const IMHandlePropertyLastName; NSString * const IMHandlePropertyEmailAddress; NSString * const IMHandlePropertyPictureIdentifier; NSString * const IMHandlePropertyPictureData; NSString * const IMHandlePropertyCapabilities;

Константы
- IMHandlePropertyAvailability
  
  IMHandlePropertyAvailability
  
  Доступность дескриптора. (IMHandleAvailability как NSNumber)
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyStatusMessage
  
  IMHandlePropertyStatusMessage
  
  Сообщение текущего статуса дескриптора. (NSString)
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyAuthorizationStatus
  
  IMHandlePropertyAuthorizationStatus
  
  Состояние авторизации. (IMHandleAuthorizationStatus как NSNumber)
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyIdleDate
  
  IMHandlePropertyIdleDate
  
  Время последнего пользовательского действия (NSDate).
  
  Этот ключ применим только для неактивных дескрипторов. Чтобы указать, что время неизвестно, используйте значение, возвращенное NSDate метод distantPast.
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyAlias
  
  IMHandlePropertyAlias
  
  Приятно отформатированная версия дескриптора (например, с пробелом и капитализацией).
  
  Если ни один не доступен, опустите это свойство.
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyFirstName
  
  IMHandlePropertyFirstName
  
  Имя (имя) дескриптора. (NSString)
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyLastName
  
  IMHandlePropertyLastName
  
  Фамилия (фамилия) дескриптора. (NSString)
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyEmailAddress
  
  IMHandlePropertyEmailAddress
  
  Адрес электронной почты дескриптора. (NSString)
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyPictureIdentifier
  
  IMHandlePropertyPictureIdentifier
  
  Уникальный идентификатор для изображения дескриптора. (NSString)
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyPictureData
  
  IMHandlePropertyPictureData
  
  Изображение дескриптора. (NSData)
  
  Включайте этот ключ только при ответе на requestPictureForHandle:withIdentifier: метод.
  
  Доступный в OS X v10.7 и позже.
- IMHandlePropertyCapabilities
  
  IMHandlePropertyCapabilities
  
  Возможности дескриптора. (NSArray из возможностей)
  
  Для списка возможностей дескриптора посмотрите Возможности Дескриптора
  
  Доступный в OS X v10.7 и позже.
Доступность дескриптора
Состояния доступности дескриптора.

Объявление

Swift

enum IMHandleAvailability : Int { case Unknown case Offline case Away case Available }

Objective C

enum { IMHandleAvailabilityUnknown = -2, IMHandleAvailabilityOffline = -1, IMHandleAvailabilityAway = 0, IMHandleAvailabilityAvailable = 1 }; typedef NSInteger IMHandleAvailability;

Константы
- Unknown
  
  IMHandleAvailabilityUnknown
  
  Неизвестная доступность.
  
  Доступный в OS X v10.7 и позже.
- Offline
  
  IMHandleAvailabilityOffline
  
  Оффлайн.
  
  Доступный в OS X v10.7 и позже.
- Away
  
  IMHandleAvailabilityAway
  
  Далеко.
  
  Доступный в OS X v10.7 и позже.
- Available
  
  IMHandleAvailabilityAvailable
  
  Доступный.
  
  Доступный в OS X v10.7 и позже.
Оператор импорта

Objective C

@import IMServicePlugIn;

Swift

import IMServicePlugIn

Доступность

Доступный в OS X v10.7 и позже.
Состояние авторизации дескриптора
Состояния запроса авторизации.

Объявление

Swift

enum IMHandleAuthorizationStatus : Int { case Accepted case Pending case Declined }

Objective C

enum { IMHandleAuthorizationStatusAccepted = 0, IMHandleAuthorizationStatusPending = 1, IMHandleAuthorizationStatusDeclined = 2 }; typedef NSInteger IMHandleAuthorizationStatus;

Константы
- Accepted
  
  IMHandleAuthorizationStatusAccepted
  
  Запрос был принят.
  
  Пользователь видит онлайн-статус дескриптора.
  
  Доступный в OS X v10.7 и позже.
- Pending
  
  IMHandleAuthorizationStatusPending
  
  Запрос находится на рассмотрении.
  
  Запрос был отправлен и ожидает утверждение.
  
  Доступный в OS X v10.7 и позже.
- Declined
  
  IMHandleAuthorizationStatusDeclined
  
  Просьба была отклонена.
  
  Доступный в OS X v10.7 и позже.
Обсуждение

IMServicePlugInGroupListAuthorizationSupport Protocol Reference и IMServiceApplicationGroupListAuthorizationSupport протоколы используются для взаимодействия с запросами авторизации.

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

Objective C

@import IMServicePlugIn;

Swift

import IMServicePlugIn

Доступность

Доступный в OS X v10.7 и позже.
Возможности дескриптора
Значения для IMHandlePropertyCapabilities ключ.

Объявление

Swift

let IMHandleCapabilityMessaging: NSString! let IMHandleCapabilityOfflineMessaging: NSString! let IMHandleCapabilityChatRoom: NSString! let IMHandleCapabilityHandlePicture: NSString! let IMHandleCapabilityFileTransfer: NSString!

Objective C

NSString * const IMHandleCapabilityMessaging; NSString * const IMHandleCapabilityOfflineMessaging; NSString * const IMHandleCapabilityChatRoom; NSString * const IMHandleCapabilityHandlePicture; NSString * const IMHandleCapabilityFileTransfer;

Константы
- IMHandleCapabilityMessaging
  
  IMHandleCapabilityMessaging
  
  Дескриптор может отправить и получить мгновенные сообщения.
  
  Доступный в OS X v10.7 и позже.
- IMHandleCapabilityOfflineMessaging
  
  IMHandleCapabilityOfflineMessaging
  
  Дескриптор может получить мгновенные сообщения когда оффлайн.
  
  Некоторые службы мгновенных сообщений хранят сообщения, отправляющиеся в оффлайновые дескрипторы и передающие сообщения, когда пользователи регистрируют, въезжают задним ходом.
  
  Доступный в OS X v10.7 и позже.
- IMHandleCapabilityChatRoom
  
  IMHandleCapabilityChatRoom
  
  Дескриптор может участвовать в чат-комнатах.
  
  Доступный в OS X v10.7 и позже.
- IMHandleCapabilityHandlePicture
  
  IMHandleCapabilityHandlePicture
  
  Дескриптор может иметь изображение.
  
  Доступный в OS X v10.7 и позже.
- IMHandleCapabilityFileTransfer
  
  IMHandleCapabilityFileTransfer
  
  Дескриптор может отправить и получить файлы.
  
  Доступный в OS X v10.7 и позже.