mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 08:16:53 +00:00
Glossary: rephrase definitions of services and actions (#33769)
This commit is contained in:
parent
b52ea0eac1
commit
3234f35f39
@ -12,14 +12,17 @@
|
|||||||
definition: |-
|
definition: |-
|
||||||
Actions are used in several places in Home Assistant. As part of a script or
|
Actions are used in several places in Home Assistant. As part of a script or
|
||||||
automation, actions define what is going to happen once a trigger is
|
automation, actions define what is going to happen once a trigger is
|
||||||
activated. In scripts, an action is called *sequence*. Actions use service
|
activated. In scripts, an action is called *sequence*. An action is a **software
|
||||||
calls and/or scenes to interact with entities and cause these entities to do
|
function that interacts with targets to make something happen**. Actions can use other actions
|
||||||
|
and/or scenes to interact with entities and cause these entities to do
|
||||||
something. Actions can also include conditions and a delay. An action can
|
something. Actions can also include conditions and a delay. An action can
|
||||||
call multiple services at the same time. For example, if your presence is
|
perform multiple actions at the same time. For example, if your presence is
|
||||||
detected in a room, an action may call one service to turn on a light and
|
detected in a room, an action may perform one action to turn on a light and
|
||||||
call another service to start playing music after a delay. Actions are also
|
perform another action to start playing music after a delay. Actions are also
|
||||||
used on the dashboard, for example as tap or hold action on a UI element.
|
used on the dashboard, for example as tap or hold action on a UI element.
|
||||||
When triggered, the action calls a service.
|
When triggered, the action performs another action. Home Assistant provides a series of predefined actions,
|
||||||
|
such as `homeassistant.turn_on`, `homeassistant.toggle`, or
|
||||||
|
`homeassistant.reload`.
|
||||||
aliases:
|
aliases:
|
||||||
- actions
|
- actions
|
||||||
link: /docs/automation/action/
|
link: /docs/automation/action/
|
||||||
@ -481,26 +484,11 @@
|
|||||||
- selectors
|
- selectors
|
||||||
- term: Service
|
- term: Service
|
||||||
definition: |-
|
definition: |-
|
||||||
The term service has 2 meanings in Home Assistant: **The information
|
The term "service" in Home Assistant is used in the sense of an **information
|
||||||
service** For example, the municipal waste management service that provides
|
service**. For example, the municipal waste management service that provides
|
||||||
entities for organic, paper, and packaging waste. In terms of functionality,
|
entities for organic, paper, and packaging waste. In terms of functionality,
|
||||||
the information service is like a device. It is called *service* to avoid
|
the information service is like a device. It is called *service* to avoid
|
||||||
confusion, as it does not come with a piece of hardware. **The software
|
confusion, as it does not come with a piece of hardware.
|
||||||
function that interacts with targets to make something happen** A service
|
|
||||||
carries out one specific task, for example: turning on the light in the
|
|
||||||
living room or sending a notification to a mobile phone. A service has
|
|
||||||
targets and data. Service targets are: areas, devices, and entities. Service
|
|
||||||
data carries the information required to define the desired state change in
|
|
||||||
the target. For example, the target, together with brightness 150 and RGB
|
|
||||||
color `[255,0,0]`, or the message “Your coffee is ready”. Services can be
|
|
||||||
used in, for example, automation, scripts, dashboards, or voice commands to
|
|
||||||
control your home. Home Assistant provides a series of predefined services,
|
|
||||||
such as `homeassistant.turn_on`, `homeassistant.toggle`, or
|
|
||||||
`homeassistant.reload`.
|
|
||||||
excerpt: >
|
|
||||||
A service carries out one specific task, for example: turn on the light in
|
|
||||||
the living room. A service has targets and data and can be called by
|
|
||||||
actions, a dashboard, or via voice command.
|
|
||||||
link: /docs/scripts/service-calls/
|
link: /docs/scripts/service-calls/
|
||||||
aliases:
|
aliases:
|
||||||
- services
|
- services
|
||||||
|
Loading…
x
Reference in New Issue
Block a user