diff --git a/docs/core/entity/remote.md b/docs/core/entity/remote.md index 24cbc340..fd8f2f3a 100644 --- a/docs/core/entity/remote.md +++ b/docs/core/entity/remote.md @@ -14,6 +14,10 @@ Properties should always only return information from memory and not do I/O (lik | current_activity | str | None | Return the current active activity | | activity_list | list | None | Return the list of available activites | +### Activity + +An activity is a predefined activity or macro that puts the remote in a specific state. For example, a "Watch TV" activity may turn on multiple devices and change the channel to a specific channel. + ## Supported Features | Constant | Description @@ -24,6 +28,42 @@ Properties should always only return information from memory and not do I/O (lik ## Methods +### Turn On Command + +```python +class MyRemote(RemoteEntity): + + def turn_on(self, activity: str = None, **kwargs): + """Turn the remote on.""" + + async def async_turn_on(self, activity: str = None, **kwargs): + """Turn the remote on.""" +``` + +### Turn Off Command + +```python +class MyRemote(RemoteEntity): + + def turn_off(self, activity: str = None, **kwargs): + """Turn the remote off.""" + + async def async_turn_off(self, activity: str = None, **kwargs): + """Turn the remote off.""" +``` + +### Toggle Command + +```python +class MyRemote(RemoteEntity): + + def toggle(self, activity: str = None, **kwargs): + """Toggle the remote.""" + + async def async_toggle(self, activity: str = None, **kwargs): + """Toggle the remote.""" +``` + ### Send Command ```python