hs.distributednotifications

Взаимодействие с NSDistributedNotificationCenter. Существует множество уведомлений, публикуемых частями OS X и сторонними приложениями, на которые можно реагировать с помощью этого модуля.

Вы можете обнаружить уведомления, публикуемые на вашей системе, с помощью кода примерно такого:

foo = hs.distributednotifications.new(function(name, object, userInfo) print(string.format("name: %s\nobject: %s\nuserInfo: %s\n", name, object, hs.inspect(userInfo))) end)
foo:start()

Обратите внимание, что распределённые уведомления ресурсоёмкие — они подразумевают множество межпроцессных взаимодействий. Также обратите внимание, что их доставка не гарантируется, особенно если система сильно загружена.

Обзор API

Функции — API-вызовы, предоставляемые напрямую расширением

post

Конструкторы — API-вызовы, возвращающие объект, обычно тот, что предлагает API-методы

Методы — API-вызовы, которые могут быть выполнены только с объектом, возвращённым конструктором

start
stop

Документация API

Функции

post

Подпись	`hs.distributednotifications.post(name[, sender[, userInfo]])`
Тип	Функция
Описание	Отправляет распределённое уведомление
Параметры	name — строка, содержащая имя уведомления sender — необязательная строка, содержащая имя отправителя уведомления (в формате `com.domain.application.foo`). По умолчанию nil. userInfo — необязательная таблица, содержащая дополнительную информацию для публикации вместе с уведомлением. По умолчанию nil.
Возвращает	Ничего
Исходный код	extensions/distributednotifications/libdistributednotifications.m строка 81

Конструкторы

new

Подпись	`hs.distributednotifications.new(callback[, name[, object]]) -> object`
Тип	Конструктор
Описание	Создаёт новый наблюдатель NSDistributedNotificationCenter
Параметры	callback — функция, вызываемая при поступлении соответствующего уведомления. Функция должна принимать один аргумент: notificationName — строка, содержащая имя уведомления name — необязательная строка, содержащая имя уведомлений для наблюдения. Значение `nil` вызовет наблюдение за всеми уведомлениями на версиях macOS до Catalina. По умолчанию `nil`. object — необязательная строка, содержащая имя отправляющих объектов для наблюдения. Значение `nil` вызовет наблюдение за всеми отправляющими объектами. По умолчанию `nil`.
Возвращает	Объект `hs.distributednotifications`
Примечания	На Catalina и выше больше нельзя наблюдать за всеми уведомлениями — параметр `name` теперь фактически требуется. См. https://mjtsai.com/blog/2019/10/04/nsdistributednotificationcenter-no-longer-supports-nil-names
Исходный код	extensions/distributednotifications/libdistributednotifications.m строка 40

Методы

start

Подпись	`hs.distributednotifications:start() -> object`
Тип	Метод
Описание	Запускает наблюдатель NSDistributedNotificationCenter
Параметры	Ничего
Возвращает	Объект `hs.distributednotifications`
Исходный код	extensions/distributednotifications/libdistributednotifications.m строка 119

stop

Подпись	`hs.distributednotifications:stop() -> object`
Тип	Метод
Описание	Останавливает наблюдателя NSDistributedNotificationCenter
Параметры	Ничего
Возвращает	Объект `hs.distributednotifications`
Исходный код	extensions/distributednotifications/libdistributednotifications.m строка 142

© 2014–2017 Hammerspoon contributors
Licensed under the MIT License.
https://www.hammerspoon.org/docs/hs.distributednotifications.html