openCom-Companion/sbapp/plyer/facades/vibrator.py
2022-09-16 18:07:57 +02:00

98 lines
2.1 KiB
Python

'''
Vibrator
=======
The :class:`Vibrator` provides access to public methods to use vibrator of your
device.
.. note::
On Android your app needs the VIBRATE permission to
access the vibrator.
Simple Examples
---------------
To vibrate your device::
>>> from plyer import vibrator
>>> time=2
>>> vibrator.vibrate(time=time)
To set a pattern::
>>> vibrator.pattern(pattern=pattern, repeat=repeat)
To know whether vibrator exists or not::
>>> vibrator.exists()
To cancel vibration::
>>> vibrator.cancel()
Supported Platforms
-------------------
Android, iOS
'''
class Vibrator:
'''
Vibration facade.
'''
def vibrate(self, time=1):
'''
Ask the vibrator to vibrate for the given period.
:param time: Time to vibrate for, in seconds. Default is 1.
'''
self._vibrate(time=time)
def pattern(self, pattern=(0, 1), repeat=-1):
'''
Ask the vibrator to vibrate with the given pattern, with an
optional repeat.
:param pattern: Pattern to vibrate with. Should be a list of
times in seconds. The first number is how long to wait
before vibrating, and subsequent numbers are times to
vibrate and not vibrate alternately.
Defaults to ``[0, 1]``.
:param repeat: Index at which to repeat the pattern. When the
vibration pattern reaches this index, it will start again
from the beginning. Defaults to ``-1``, which means no
repeat.
'''
self._pattern(pattern=pattern, repeat=repeat)
def exists(self):
'''
Check if the device has a vibrator. Returns True or
False.
'''
return self._exists()
def cancel(self):
'''
Cancels any current vibration, and stops the vibrator.
'''
self._cancel()
# private
def _vibrate(self, **kwargs):
raise NotImplementedError()
def _pattern(self, **kwargs):
raise NotImplementedError()
def _exists(self, **kwargs):
raise NotImplementedError()
def _cancel(self, **kwargs):
raise NotImplementedError()