openCom-Companion/sbapp/plyer/facades/irblaster.py

105 lines
2.5 KiB
Python
Raw Normal View History

2022-09-16 18:07:57 +02:00
'''
IrBlaster
============
The :class:`IrBlaster` provides access to public methods by which your device
can act as a remote and could be used to control your TV, AC, Music Player,
Projectors, Set top box or anything that can be controlled by a remote.
.. note::
- On Android your app needs the TRANSMIT_IR permission which allows an
application to use the device's IR transmitter, If available.
Simple Examples
---------------
To get transmit an IR sequence::
>>> from plyer import irblaster
>>> irblaster.transmit(frequency, pattern, mode)
To get frequencies::
>>> irblaster.frequencies
To check if IrBlaster exists::
>>> irblaster.exists()
True/False
Supported Platforms
-------------------
Android
'''
class IrBlaster:
'''
Infrared blaster facade.
'''
@staticmethod
def periods_to_microseconds(frequency, pattern):
'''
Convert a pattern from period counts to microseconds.
'''
period = 1000000. / frequency
return [period * x for x in pattern]
@staticmethod
def microseconds_to_periods(frequency, pattern):
'''
Convert a pattern from microseconds to period counts.
'''
period = 1000000. / frequency
return [x / period for x in pattern]
@property
def frequencies(self):
'''
Property which contains a list of frequency ranges
supported by the device in the form:
[(from1, to1),
(from2, to2),
...
(fromN, toN)]
'''
return self.get_frequencies()
def get_frequencies(self):
return self._get_frequencies()
def transmit(self, frequency, pattern, mode='period'):
'''
Transmit an IR sequence.
:parameters:
`frequency`: int
Carrier frequency for the IR transmission.
`pattern`: list[int]
Burst pair pattern to transmit.
`mode`: str, defaults to 'period'
Specifies the format of the pattern values.
Can be 'period' or 'microseconds'.
'''
return self._transmit(frequency, pattern, mode)
def exists(self):
'''
Check if the device has an infrared emitter.
'''
return self._exists()
# private
def _get_frequencies(self):
raise NotImplementedError()
def _transmit(self, frequency, pattern, mode):
raise NotImplementedError()
def _exists(self):
raise NotImplementedError()