Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы InstantMessage ссылка класса IMService

Опции
Развертывание Target:

На этой странице
Язык:

IMService

IMService класс обеспечивает методы для получения информации о мгновенной службе сообщений. Каждый IMService объект представляет одну службу, доступную через iChat. Методы класса такой как allServices и serviceWithName: возвратите эти объекты. Каждый объект представляет единственную службу мгновенных сообщений, позволяя Вам получить доступ к состоянию iChat пользователя, списку пользователя приятелей и другой информации, которая может быть интегрирована в Ваше приложение. Множество уведомлений состояния, связанных с состоянием и предпочтениями пользователя, отправляется пользовательским центром уведомления IMService.

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

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

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

Swift

import InstantMessage

Objective C

@import InstantMessage;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.

Доступ к службам мгновенных сообщений
  • allServices + allServices (OS X v10.9)

    Возвращает массив в настоящее время доступных служб.

    Объявление

    Objective C

    + (NSArray *)allServices

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

    Возвраты NSArray из IMService объекты, соответствующие текущим доступным службам (AIM, Добрый день, и т.д.).

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    + serviceWithName:

  • serviceWithName: + serviceWithName: (OS X v10.9)

    Возвращает указанную службу.

    Объявление

    Objective C

    + (IMService *)serviceWithName:(NSString *)name

    Параметры

    name

    Имя службы, как возвращено предыдущим вызовом к name метод. Жесткое кодирование, которое называет служба, не рекомендуется.

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

    Служба, указанная name.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    + allServices
    – имя

Доступ к атрибутам службы
  • imageURLForStatus: + imageURLForStatus: (OS X v10.5)

    Возвращает URL изображения для указанного состояния лица.

    Объявление

    Objective C

    + (NSURL *)imageURLForStatus:(IMPersonStatus)status

    Параметры

    status

    Состояние лица. Посмотрите IMPersonStatus для возможных значений.

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

    Изображение, отражающее текущий онлайн-статус лица; изображение обычно является цветным пузырем или треугольником.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.5.

    См. также

    + imageNameForStatus:

  • imageNameForStatus: + imageNameForStatus: (OS X v10.9)

    Возвращает имя изображения для указанного состояния лица.

    Объявление

    Objective C

    + (NSString *)imageNameForStatus:(IMPersonStatus)status

    Параметры

    status

    Состояние лица. Посмотрите IMPersonStatus для возможных значений.

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

    Имя изображения, отражающего текущий онлайн-статус лица; это обычно - цветной пузырь или треугольник.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    + myStatus

  • myIdleTime + myIdleTime (OS X v10.9)

    Возвращает число секунд, что текущий пользователь неактивен.

    Объявление

    Objective C

    + (NSDate *)myIdleTime

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

    Число секунд, что текущий пользователь неактивен.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

  • myStatus + myStatus (OS X v10.9)

    Возвращает состояние текущего пользователя.

    Объявление

    Objective C

    + (IMPersonStatus)myStatus

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

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

    Обсуждение

    Это состояние является глобальной переменной через все службы.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    + imageNameForStatus:

  • notificationCenter + notificationCenter (OS X v10.9)

    Возвращает пользовательский центр уведомления службы.

    Объявление

    Objective C

    + (NSNotificationCenter *)notificationCenter

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

    Управляющий пользовательский центр уведомления IMService уведомления.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

  • localizedName - localizedName (OS X v10.9)

    Возвращает видимое пользователем локализованное имя службы.

    Объявление

    Objective C

    - (NSString *)localizedName

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

    Видимое пользователем локализованное имя службы, такой как «Пейджер AOL» или «Добрый день».

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    – localizedShortName
    – имя

  • localizedShortName - localizedShortName (OS X v10.9)

    Возвращает короткую версию, при наличии, видимого пользователем локализованного имени службы.

    Объявление

    Objective C

    - (NSString *)localizedShortName

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

    Видимое пользователем короткое локализованное имя службы, такой как «AOL».

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    – localizedName
    – имя

  • имя - имя (OS X v10.9)

    Возвращает фиксированное каноническое имя службы.

    Объявление

    Objective C

    - (NSString *)name

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

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

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    – localizedName
    – localizedShortName

  • состояние - состояние (OS X v10.9)

    Возвращает состояние входа в систему службы.

    Объявление

    Objective C

    - (IMServiceStatus)status

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

    Состояние входа в систему службы. Одна из констант описана в IMServiceStatus.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

Доступ к приятелям
  • peopleWithScreenName: - peopleWithScreenName: (OS X v10.9)

    Записи Адресной книги возвратов, соответствующие указанный псевдоним приятеля.

    Объявление

    Objective C

    - (NSArray *)peopleWithScreenName:(NSString *)screenName

    Параметры

    screenName

    Псевдоним приятеля.

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

    Массив записей Адресной книги, соответствующих указанный псевдоним приятеля. Если там не идет ни в какое сравнение, возвращает пустой массив.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    – screenNamesForPerson:

  • screenNamesForPerson: - screenNamesForPerson: (OS X v10.9)

    Возвращает массив строк, которые являются допустимыми псевдонимами для указанного лица.

    Объявление

    Objective C

    - (NSArray *)screenNamesForPerson:(ABPerson *)person

    Параметры

    person

    Запись в Адресной книге.

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

    Массив допустимых псевдонимов для указанного лица. Если там не идет ни в какое сравнение, возвращает пустой массив.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    – peopleWithScreenName:

  • infoForAllScreenNames - infoForAllScreenNames (OS X v10.9)

    Информация о возвратах обо всех приятелях для службы.

    Объявление

    Objective C

    - (NSArray *)infoForAllScreenNames

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

    Словари, возвращенные infoForScreenName: для всех приятелей.

    Обсуждение

    Если у текущего пользователя есть многократные приятели для того же лица (определенный Адресной книгой пользователя), этот метод возвращает информацию для всех учетных записей, принадлежащих тому лицу.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    – infoForPreferredScreenNames
    – infoForScreenName:

  • infoForPreferredScreenNames - infoForPreferredScreenNames (OS X v10.9)

    Информация о возвратах о просто предпочтительных счетах на всех приятелей.

    Объявление

    Objective C

    - (NSArray *)infoForPreferredScreenNames

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

    Массив словарей, возвращенных infoForScreenName: для всех предпочтительных учетных записей.

    Обсуждение

    Если у текущего пользователя есть многократные приятели для того же лица (определенный Адресной книгой пользователя), этот метод возвращает только информацию для предпочтительных учетных записей, принадлежащих тому лицу. Предпочтительная учетная запись определяется iChat, с помощью комбинации возможностей (возможность видео-чата, аудио возможность чата, и т.д.), состояние (доступный, неактивный, далеко), и другие пользовательские атрибуты.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    – infoForAllScreenNames
    – infoForScreenName:

  • infoForScreenName: - infoForScreenName: (OS X v10.9)

    Информация о возвратах о приятеле с указанным псевдонимом.

    Объявление

    Objective C

    - (NSDictionary *)infoForScreenName:(NSString *)screenName

    Параметры

    screenName

    Псевдоним для приятеля.

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

    Информация о приятеле с указанным псевдонимом. Посмотрите “Screen Name Properties” для пар ключ/значение, появляющихся в этом словаре.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

    См. также

    – infoForAllScreenNames
    – infoForPreferredScreenNames

Константы
  • Свойства псевдонима

    Ключи для получения информации о лице вошли в систему мгновенной службы сообщений — в частности, приятель, появляющийся в списке контактов пользователя:

    Объявление

    Objective C

    extern NSString *IMPersonAVBusyKey; extern NSString *IMPersonCapabilitiesKey; extern NSString *IMPersonEmailKey; extern NSString *IMPersonFirstNameKey; extern NSString *IMPersonIdleSinceKey; extern NSString *IMPersonLastNameKey; extern NSString *IMPersonPictureDataKey; extern NSString *IMPersonScreenNameKey; extern NSString *IMPersonServiceNameKey; extern NSString *IMPersonStatusKey; extern NSString *IMPersonStatusMessageKey;

    Константы

    • IMPersonAVBusyKey

      IMPersonAVBusyKey

      Используемый для получения состояния занятости лица. Значение NSNumber набор к 0 если аудио/видео возможности лица доступны, или 1 если они заняты.

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

      Осуждаемый в OS X v10.9.

    • IMPersonCapabilitiesKey

      IMPersonCapabilitiesKey

      Используемый для получения возможностей iChat лица. Значение NSArray из свойств возможности. Посмотрите “Person Capability Values” для получения дополнительной информации.

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

      Осуждаемый в OS X v10.9.

    • IMPersonEmailKey

      IMPersonEmailKey

      Используемый для получения адреса электронной почты лица. Значение NSString содержа адрес электронной почты лица. Это - ключ, используемый непосредственно Добрый день; однако, если лицу связали запись Адресной книги с соответствующей учетной записью AIM, этот ключ отражает первый адрес электронной почты того лица.

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

      Осуждаемый в OS X v10.9.

    • IMPersonFirstNameKey

      IMPersonFirstNameKey

      Используемый для получения имени лица. Значение NSString содержа имя лица. Это - ключ, используемый непосредственно Добрый день; однако, если лицу связали запись Адресной книги с соответствующей учетной записью AIM, этот ключ отражает имя того лица.

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

      Осуждаемый в OS X v10.9.

    • IMPersonIdleSinceKey

      IMPersonIdleSinceKey

      Используемый для получения неактивного состояния лица. Значение NSDate содержа время, в секундах, начиная с последнего пользовательского действия. Доступный, если состояние лица неактивно.

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

      Осуждаемый в OS X v10.9.

    • IMPersonLastNameKey

      IMPersonLastNameKey

      Используемый для получения фамилии лица. Значение NSString содержа фамилию лица. Это - ключ, используемый непосредственно Добрый день; однако, если лицу связали запись Адресной книги с соответствующей учетной записью AIM, этот ключ отражает фамилию того лица.

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

      Осуждаемый в OS X v10.9.

    • IMPersonPictureDataKey

      IMPersonPictureDataKey

      Используемый для получения изображения лица. Значение NSData содержа изображение для значка лица.

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

      Осуждаемый в OS X v10.9.

    • IMPersonScreenNameKey

      IMPersonScreenNameKey

      Используемый для получения псевдонима лица. Значение NSString содержа специфичный для службы идентификатор для лица. Например, «User123» или «steve@mac .com» для AIM и «Джона Доу» для Добрый день.

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

      Осуждаемый в OS X v10.9.

    • IMPersonServiceNameKey

      IMPersonServiceNameKey

      Используемый для получения имени службы лица. Значение NSString содержа имя службы это лицо принадлежит.

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

      Осуждаемый в OS X v10.9.

    • IMPersonStatusKey

      IMPersonStatusKey

      Используемый для получения онлайн-статуса лица. Значение NSNumber представление текущего онлайн-статуса лица, если известный. Посмотрите “IMPersonStatus” для получения дополнительной информации.

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

      Осуждаемый в OS X v10.9.

    • IMPersonStatusMessageKey

      IMPersonStatusMessageKey

      Используемый для получения сообщения о состоянии лица. Значение NSString содержа сообщение текущего статуса лица.

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

      Осуждаемый в OS X v10.9.

    Обсуждение

    Эти ключи появляются в словаре, возвращенном infoForScreenName: метод.

  • Значения возможности лица

    Возможности iChat лица получили доступ к использованию IMPersonCapabilitiesKey ключ.

    Объявление

    Objective C

    extern NSString *IMCapabilityAudioConference; extern NSString *IMCapabilityDirectIM; extern NSString *IMCapabilityFileSharing; extern NSString *IMCapabilityFileTransfer; extern NSString *IMCapabilityText; extern NSString *IMCapabilityVideoConference;

    Константы

    • IMCapabilityAudioConference

      IMCapabilityAudioConference

      У лица есть аудио возможность чата.

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

      Осуждаемый в OS X v10.9.

    • IMCapabilityDirectIM

      IMCapabilityDirectIM

      У лица есть прямая возможность подключения.

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

      Осуждаемый в OS X v10.9.

    • IMCapabilityFileSharing

      IMCapabilityFileSharing

      У лица есть возможность совместного доступа к файлам.

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

      Осуждаемый в OS X v10.9.

    • IMCapabilityFileTransfer

      IMCapabilityFileTransfer

      У лица есть возможность передачи файлов.

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

      Осуждаемый в OS X v10.9.

    • IMCapabilityText

      IMCapabilityText

      У лица есть текстовая возможность.

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

      Осуждаемый в OS X v10.9.

    • IMCapabilityVideoConference

      IMCapabilityVideoConference

      У лица есть возможность видео-чата.

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

      Осуждаемый в OS X v10.9.

  • IMServiceStatus

    Состояния службы.

    Объявление

    Objective C

    enum { IMServiceStatusLoggedOut, IMServiceStatusDisconnected, IMServiceStatusLoggingOut, IMServiceStatusLoggingIn, IMServiceStatusLoggedIn }; typedef NSUInteger IMServiceStatus;

    Константы

    • IMServiceStatusLoggedOut

      IMServiceStatusLoggedOut

      Служба в настоящее время выходится из системы.

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

    • IMServiceStatusDisconnected

      IMServiceStatusDisconnected

      Служба была разъединена, не пользователем, а системой или из-за ошибки.

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

    • IMServiceStatusLoggingOut

      IMServiceStatusLoggingOut

      Служба находится в процессе того, чтобы выходить из системы.

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

    • IMServiceStatusLoggingIn

      IMServiceStatusLoggingIn

      Служба находится в процессе входа в систему.

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

    • IMServiceStatusLoggedIn

      IMServiceStatusLoggedIn

      Служба в настоящее время зарегистрирована.

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

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

  • IMPersonStatus

    Состояние лица через все службы.

    Объявление

    Objective C

    enum { IMPersonStatusUnknown, IMPersonStatusOffline, IMPersonStatusIdle, IMPersonStatusAway, IMPersonStatusAvailable, IMPersonStatusNoStatus }; typedef NSUInteger IMPersonStatus;

    Константы

    • IMPersonStatusUnknown

      IMPersonStatusUnknown

      Состояние лица неизвестно.

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

    • IMPersonStatusOffline

      IMPersonStatusOffline

      Лицо является в настоящее время оффлайновым.

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

    • IMPersonStatusIdle

      IMPersonStatusIdle

      Лицо в настоящее время неактивно.

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

    • IMPersonStatusAway

      IMPersonStatusAway

      Лицо в настоящее время отсутствует.

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

    • IMPersonStatusAvailable

      IMPersonStatusAvailable

      Лицо в настоящее время доступно.

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

    • IMPersonStatusNoStatus

      IMPersonStatusNoStatus

      Никакое состояние не доступно.

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

    Обсуждение

    К этому получают доступ с помощью IMPersonStatusKey ключ для приятеля или возвратился myStatus метод для текущего пользователя.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

Уведомления
  • IMMyStatusChangedNotification IMMyStatusChangedNotification

    Отправленный IMService пользовательский центр уведомления, когда локальный пользователь изменяет их онлайн-статус. Объект уведомления IMService объект. Словарь информации о пользователе не содержит ключи. Получатель должен отправить myStatus к уведомлению возражают для получения нового онлайн-статуса.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

  • IMPersonInfoChangedNotification IMPersonInfoChangedNotification

    Отправленный IMService пользовательский центр уведомления, когда псевдоним изменяет некоторый аспект своей опубликованной информации. Объект уведомления IMService объект. Словарь информации о пользователе всегда содержит IMPersonScreenNameKey ключ и может содержать любой из других ключей, как описано в “Screen Name Properties”. Если определенный атрибут удален, значение для соответствующего ключа NSNull.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

  • IMPersonStatusChangedNotification IMPersonStatusChangedNotification

    Отправленный IMService пользовательский центр уведомления, когда различный приятель (псевдоним) входит в систему, выходит из системы, уходит, и т.д. Объект уведомления IMService объект. Словарь информации о пользователе всегда содержит IMPersonScreenNameKey и IMPersonStatusKey ключи и никакие другие.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

  • IMServiceStatusChangedNotification IMServiceStatusChangedNotification

    Отправленный IMService пользовательский центр уведомления, когда состояние службы изменяется — текущий пользователь, входит в систему, выходит из системы, уходит, и т.д. Объект уведомления IMService объект. Словарь информации о пользователе не содержит ключи. Получатель должен отправить status к уведомлению возражают для получения нового состояния службы.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.

  • IMStatusImagesChangedAppearanceNotification IMStatusImagesChangedAppearanceNotification

    Отправленный IMService пользовательский центр уведомления, когда текущий пользователь изменяет его или ее предпочтительные изображения для отображения состояния. Объект уведомления nil. Это уведомление не содержит словарь информации о пользователе. Используйте imageNameForStatus: метод для получения новых изображений.

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

    Objective C

    @import InstantMessage;

    Доступность

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

    Осуждаемый в OS X v10.9.