hs.battery

Возвращает таблицу, содержащую все подробности о источнике питания Mac.

• Нет

• таблица, содержащая исходные данные о источнике питания Mac.

• Эта функция, как правило, не требуется и предоставляется для отладки. Эта функция объединяет вывод следующих внутренних функций:

  • hs.battery._adapterDetails()
  • hs.battery._powerSources()
  • hs.battery._appleSmartBattery()
  • hs.battery._iopmBatteryInfo()

• Вы можете просмотреть этот отчет, набрав hs.inspect(hs.battery._report()) (или подмножество его, используя вместо этого одну из вышеперечисленных функций) — он будет интересен в основном при отладке или расширении этого модуля и, как правило, не нужен для использования.

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

• Нет

• Число или строка, содержащая серийный номер источника питания, или nil, если адаптер не подключен или не предоставляет его.

Возвращает количество тока, протекающего через батарею, в мАч.

• Нет

• Число, содержащее количество тока, протекающего через батарею. Значение может быть:
• Меньше нуля, если батарея разряжается (т. е. компьютер работает от батареи)
• Ноль, если батарея не заряжается и не разряжается
• Больше нуля, если батарея заряжается

Возвращает серийный номер батареи, если он есть.

• Нет

• Строка, содержащая серийный номер батареи, или nil, если батареи нет или батарея/ИБП не предоставляет его.

Возвращает тип присутствующей батареи или nil, если батареи нет.

• Нет

• Строка, содержащая «ИБП» или «Внутренняя батарея», или nil, если батареи нет.

Возвращает текущую емкость батареи в мАч.

• Нет

• Число, содержащее текущую емкость батареи в мАч.

• Это мера того, насколько заряжена батарея, по сравнению со значением hs.battery.maxCapacity()

Возвращает количество циклов разрядки батареи.

• Нет

• Количество циклов

• Один цикл — это полная разрядка батареи, за которой следует полная зарядка. Это также может быть совокупностью многих меньших циклов разряда-зарядки (например, 10 итераций разрядки батареи с 100% до 90% и последующей зарядки до 100% каждый раз считается одним циклом).

Возвращает расчетную емкость батареи в мАч.

• Нет

• Число, содержащее номинальную максимальную емкость батареи

Получить всю доступную информацию о батарее.

• Нет

• Таблица, содержащая всю информацию, предоставляемую отдельными функциями в hs.battery

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

Возвращает состояние здоровья батареи.

• Нет

• Строка, содержащая одно из {Хорошее, Удовлетворительное, Плохое}, как определено контроллером Apple Smart Battery.

Возвращает состояние здоровья батареи.

• Нет

• Nil, если нет данных о состоянии здоровья, или строка, содержащая:
• «Проверить батарею»
• «Постоянный отказ батареи»

Возвращает состояние заряда батареи.

• Нет

• True, если батарея заряжена, false — если нет.

Возвращает состояние зарядки батареи

• None

• True, если батарея заряжается, false — если нет

Возвращает true, если батарея завершает зарядку

• None

• True, если батарея находится в конечной стадии зарядки (например, подзарядка), false — если нет

Возвращает максимальную емкость батареи в мАч

• None

• Число, содержащее наблюдаемую максимальную емкость батареи в мАч

• Это значение может превышать hs.battery.designCapacity() из-за небольших вариаций в производственной химии по сравнению с проектом

Возвращает имя батареи

• None

• Строка, содержащая имя батареи

Возвращает информацию о батареях, не являющихся блоками питания (например, аксессуарах Bluetooth)

• None

• Таблица, содержащая информацию об остальных известных системе батареях, или пустая таблица, если устройства не найдены

Возвращает текущий процент заряда батареи

• None

• Число, содержащее процент заряда батареи

Возвращает текущий источник питания

• None

• Строка, содержащая одно из значений: {Питание от сети, Питание от батареи, Питание от ИБП}.

Возвращает текущий тип источника питания

• None

• Строка, содержащая одно из значений: {Питание от сети, Питание от батареи, Отключено}.

Возвращает информацию об устройствах Bluetooth, используя частные API Apple

• None

• Таблица, содержащая информацию об устройствах, использующих частные API Apple.

• Эта функция использует частные API Apple — это значит, что она может сломаться без предупреждения при обновлении macOS. Пожалуйста, сообщите нам о сбоях!
• Эта функция вернёт информацию обо всех подключенных устройствах Bluetooth, но большая часть её будет бесполезной для большинства устройств
• Таблица содержит следующие ключи:
  • vendorID — числовой идентификатор производителя устройства (идентификатор Apple — 76)
  • productID — числовой идентификатор устройства
  • address — адрес Bluetooth устройства
  • isApple — строка, содержащая "ДА" или "НЕТ", в зависимости от того, является ли это продуктом Apple/Beats или продуктом сторонних разработчиков
  • name — читаемая человеком строка, содержащая имя устройства
  • batteryPercentSingle — для некоторых устройств это будет содержать процент батареи (например, наушники Beats)
  • batteryPercentCombined — нам пока не понятно, что представляет собой это поле. Пожалуйста, сообщите, если вы найдёте здесь ненулевое значение
  • batteryPercentCase — процент заряда батареи футляров AirPods (обратите внимание, что часто это значение будет 0 — футляр AirPods агрессивно переходит в спящий режим)
  • batteryPercentLeft — процент заряда батареи левого наушника AirPods, если он находится вне футляра
  • batteryPercentRight — процент заряда батареи правого наушника AirPods, если он находится вне футляра
  • buttonMode — нам пока не понятно, что представляет собой это поле. Пожалуйста, сообщите, если вы найдёте значение, отличное от 1
  • micMode — для AirPods это соответствует параметру микрофона в настройках Bluetooth устройства
  • leftDoubleTap — для AirPods это соответствует действию двойного касания левой гарнитуры в настройках Bluetooth устройства
  • rightDoubleTap — для AirPods это соответствует действию двойного касания правой гарнитуры в настройках Bluetooth устройства
  • primaryBud — для AirPods это либо «left», либо «right», в зависимости от того, какой наушник в настоящее время считается основным устройством
  • primaryInEar — для AirPods это «ДА» или «НЕТ», в зависимости от того, находится ли основной наушник в ухе
  • secondaryInEar — для AirPods это «ДА» или «НЕТ», в зависимости от того, находится ли дополнительный наушник в ухе
  • isInEarDetectionSupported — поддерживает ли данное устройство обнаружение, когда оно находится в ухе
  • isEnhancedDoubleTapSupported — поддерживает ли это устройство улучшенное двойное касание
  • isANCSupported — мы полагаем, что это, скорее всего, указывает на поддержку активного шумоподавления (например, Beats Solo)
• Пожалуйста, сообщайте о любых сбоях этой функции — вероятно, есть устройства Bluetooth, которые мы не тестировали, которые могут возвращать странные данные
• Многие/Большинство/Все продукты сторонних разработчиков, скорее всего, вернут нули для всех полей, связанных с батареей, так же, как и устройства Apple HID. Похоже, что эти частные API в основном предназначены для поддержки наушников Apple/Beats.

Возвращает оставшееся время работы батареи в минутах

• None

• Число, содержащее оставшиеся минуты работы батареи. Значение может быть:
• Больше нуля, чтобы указать количество оставшихся минут
• -1, если оставшееся время работы батареи все еще рассчитывается
• -2, если оставшееся время работы батареи неограниченно (например, система подключена к сети)

Возвращает оставшееся время до полной зарядки батареи в минутах

• None

• Число, содержащее оставшееся время (в минутах) до полной зарядки батареи, или -1, если оставшееся время все еще рассчитывается

Возвращает текущее напряжение батареи в мВ

• None

• Число, содержащее текущее напряжение батареи

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

• Нет

• строка, определяющая текущее состояние уровня предупреждения. Строка будет одной из "none", "low" или "critical".

• Значение возвращаемых строк следующее:
  • "none" - указывает, что система не находится в ситуации низкого заряда батареи или в настоящее время подключена к источнику питания переменного тока.
  • "low" - система находится в ситуации низкого заряда батареи и может обеспечить не более 20 минут работы. Обратите внимание, что это лишь предположение; 20 минут не гарантируются и будут сильно зависеть от того, что компьютер делает в данный момент, от количества работающих приложений, яркости экрана и т. д.
  • "critical" - система находится в ситуации очень низкого заряда батареи и может обеспечить не более 10 минут работы. Обратите внимание, что это лишь предположение; 10 минут не гарантируются и будут сильно зависеть от того, что компьютер делает в данный момент, от количества работающих приложений, яркости экрана и т. д.

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

• Нет

• Число, содержащее скорость преобразования энергии в батарее. Значение может быть:
• Меньше нуля, если батарея разряжается (т.е. компьютер работает от батареи)
• Ноль, если батарея не заряжается и не разряжается
• Больше нуля, если батарея заряжается