脚本语法 - 家庭助理必威是什么</标题><link href="//www.jameselles.com/docs/stylesheets/prism.css?8acb84bc0387c9548a63998fcfea0139" rel="stylesheet"> <link href="//www.jameselles.com/docs/stylesheets/screen.css?a2ce8e4e14977c84233d76cd7564f35b" media="screen, projection, print" rel="stylesheet"> </head> <body> <header class="site-header"> <div class="grid-wrapper"> <div class="grid"> <div class="grid__item three-tenths lap-two-sixths palm-one-whole ha-title"> <a href="//www.jameselles.com/docs/docs/" class="site-title"><img src="//www.jameselles.com/docs/images/home-assistant-logo.svg" width="36" height="36" alt="必威是什么"><span>必威是什么</span></a> </div> <div class="grid__item seven-tenths lap-four-sixths palm-one-whole"> <nav> <input type="checkbox" id="toggle"> <label for="toggle" class="toggle" data-open="Main Menu" data-close="Close Menu"></label> <ul class="menu pull-right"> <li><a href="//www.jameselles.com/docs/getting-started/">入门</A></li> <li><a href="//www.jameselles.com/docs/docs/">文档<i class="icon icon-caret-down"></i></a> <ul> <li><a href="//www.jameselles.com/docs/installation/">安装</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/">配置</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/">自动化</A></li> <li><a href="//www.jameselles.com/docs/docs/scripts/">脚本</A></li> <li><a href="//www.jameselles.com/docs/dashboards/">仪表板</A></li> </ul></li> <li><a href="//www.jameselles.com/docs/integrations/">集成</A></li> <li><a href="//www.jameselles.com/docs/examples/">例子</A></li> <li><a href="//www.jameselles.com/docs/blog/">博客</A></li> <li><a href="//www.jameselles.com/docs/help/">需要帮忙？</A></li> <li><a href="//www.jameselles.com/docs/scripts/#" class="show-search" aria-label="Show search"><i class="icon-search"></i></a></li> </ul> </nav> <div class="search-container" style="display: none"> <div class="search"> <i class="icon-search"></i> <input id="search" placeholder="Search the documentation…"> <a href="//www.jameselles.com/docs/scripts/#" class="close"><i class="icon-remove-sign"></i></a> </div> </div> </div> </div> </div> </header> <div class="page-content"> <div class="grid-wrapper"> <div class="grid grid-center"> <div class="grid__item two-thirds lap-one-whole palm-one-whole"> <article class="page"> <header> <h1 class="title indent">脚本语法</h1> </header> <hr class="divider"> <p>脚本是<span class="terminology">动作<span class="terminology-tooltip">在家庭助理的多个地方使用动作。必威是什么作为脚本或自动化的一部分，动作定义一旦激活触发器，将会发生什么。在脚本中，一个动作称为<em>顺序</em>。<br><a class="terminology-link" href="//www.jameselles.com/docs/docs/automation/action/" target="_blank">[了解更多]</A></span></span>该家庭助理必威是什么将执行。脚本可以通过独立作为实体获得<Ahref="//www.jameselles.com/docs/integrations/script/">脚本集成</A>但也可以嵌入<span class="terminology">自动化<span class="terminology-tooltip">家庭助理的自动化使您可以自动响必威是什么应房屋内部和周围发生的事情。必威体育存款<br><a class="terminology-link" href="//www.jameselles.com/docs/docs/automation/" target="_blank">[了解更多]</A></span></span>和<Ahref="//www.jameselles.com/docs/integrations/alexa/">Alexa/Amazon Echo</A>配置。</p> <p>在自动化中执行脚本时<code>扳机</code>可变量可用。看<Ahref="//www.jameselles.com/docs/docs/automation/templating/">可用的触发数据</A>。</p> <p>脚本语法基本结构是包含操作的键/值映射的列表。如果脚本仅包含1个操作，则可以省略包装列表。</p> <p>所有动作都支持可选的<code>别名</code>。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃包含脚本语法的示例脚本集成</span><span class="na">脚本</span><span class="pi">：</span><span class="na">example_script</span><span class="pi">：</span><span class="na">顺序</span><span class="pi">：</span><span class="c1">＃这是使用脚本语法编写的</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">转动</span><span class="nv"></span><span class="s">在</span><span class="nv"></span><span class="s">天花板</span><span class="nv"></span><span class="s">光”</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_on</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">光线</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">通知</span><span class="nv"></span><span class="s">那</span><span class="nv"></span><span class="s">天花板</span><span class="nv"></span><span class="s">光</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">转身</span><span class="nv"></span><span class="s">在”</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.notify</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">转身</span><span class="nv"></span><span class="s">在</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">天花板</span><span class="nv"></span><span class="s">光！”</span></code></pre> </div> </div> <ul id="toc" class="section-nav"> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#call-a-service">致电服务</A><ul> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#activate-a-scene">激活场景</A></li> </ul></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#variables">变量</A><ul> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#scope-of-variables">变量范围</A></li> </ul></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#test-a-condition">测试条件</A></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#wait-for-time-to-pass-delay">等待时间通过（延迟）</A></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#wait">等待</A><ul> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#wait-for-a-template">等待模板</A></li> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#wait-for-a-trigger">等待扳机</A></li> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#wait-timeout">等待超时</A></li> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#wait-variable">等待变量</A></li> </ul></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#fire-an-event">解雇活动</A><ul> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#raise-and-consume-custom-events">提高和消费自定义活动</A></li> </ul></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#repeat-a-group-of-actions">重复一组动作</A><ul> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#counted-repeat">计数重复</A></li> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#for-each">每个</A></li> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#while-loop">循环</A></li> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#repeat-until">重复直到</A></li> <li class="toc-entry toc-h3"><a href="//www.jameselles.com/docs/scripts/#repeat-loop-variable">重复循环变量</A></li> </ul></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#if-then">如果然后</A></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#choose-a-group-of-actions">选择一组动作</A></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#parallelizing-actions">并行操作</A></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#stopping-a-script-sequence">停止脚本序列</A></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#continuing-on-error">继续错误</A></li> <li class="toc-entry toc-h2"><a href="//www.jameselles.com/docs/scripts/#disabling-an-action">禁用行动</A></li> </ul> <h2><a class="title-link" name="call-a-service" href="//www.jameselles.com/docs/scripts/#call-a-service"></a>致电服务</h2> <p>最重要的是调用服务的行动。这可以通过各种方式完成。对于所有不同的可能性，请看一下<Ahref="//www.jameselles.com/docs/docs/scripts/service-calls/">服务电话页面</A>。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">卧室</span><span class="nv"></span><span class="s">灯</span><span class="nv"></span><span class="s">在”</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_on</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">group.bedroom</span><span class="na">数据</span><span class="pi">：</span><span class="na">亮度</span><span class="pi">：</span><span class="m">100</span></code></pre> </div> </div> <h3><a class="title-link" name="activate-a-scene" href="//www.jameselles.com/docs/scripts/#activate-a-scene"></a>激活场景</h3> <p>脚本还可以使用快捷方式语法激活场景，而不是调用<code>scene.turn_on</code>服务。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">场景</span><span class="pi">：</span><span class="s">scene.morning_living_room</span></code></pre> </div> </div> <h2><a class="title-link" name="variables" href="//www.jameselles.com/docs/scripts/#variables"></a>变量</h2> <p>变量操作允许您设置/覆盖变量，这些变量将通过模板之后的模板访问。也可以看看<Ahref="//www.jameselles.com/docs/integrations/script/">脚本变量</A>有关如何定义整个脚本中可访问的变量。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">放</span><span class="nv"></span><span class="s">变量”</span><span class="na">变量</span><span class="pi">：</span><span class="na">实体</span><span class="pi">：</span><span class="pi">-</span><span class="s">Light.Kitchen</span><span class="pi">-</span><span class="s">light.living_room</span><span class="na">亮度</span><span class="pi">：</span><span class="m">100</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">控制</span><span class="nv"></span><span class="s">灯”</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_on</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">实体</span><span class="nv"></span><span class="s">}}””</span><span class="na">数据</span><span class="pi">：</span><span class="na">亮度</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">亮度</span><span class="nv"></span><span class="s">}}””</span></code></pre> </div> </div> <p>变量可以被模板。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">放</span><span class="nv"></span><span class="s">A</span><span class="nv"></span><span class="s">模板</span><span class="nv"></span><span class="s">多变的”</span><span class="na">变量</span><span class="pi">：</span><span class="na">blind_state_message</span><span class="pi">：</span><span class="s2">“</span><span class="s">这</span><span class="nv"></span><span class="s">瞎的</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">{{</span><span class="nv"></span><span class="s">国家（“ cover.blind”）</span><span class="nv"></span><span class="s">}}。”</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">通知</span><span class="nv"></span><span class="s">关于</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">状态</span><span class="nv"></span><span class="s">的</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">瞎的”</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.mobile_app_iphone</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">blind_state_message</span><span class="nv"></span><span class="s">}}””</span></code></pre> </div> </div> <h3><a class="title-link" name="scope-of-variables" href="//www.jameselles.com/docs/scripts/#scope-of-variables"></a>变量范围</h3> <p>变量具有本地范围。这意味着，如果变量在嵌套序列块中更改，则该变化将在外部序列块中看到。</p> <p>在 - 的里面<code>如果</code>序列<code>变量</code>动作只会改变<code>人们</code>该序列可变。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">顺序</span><span class="pi">：</span><span class="c1">＃将变量设置为默认值</span><span class="pi">-</span><span class="na">变量</span><span class="pi">：</span><span class="na">人们</span><span class="pi">：</span><span class="m">0</span><span class="c1">＃如果保卢斯在家，请尝试增加人们</span><span class="pi">-</span><span class="na">如果</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">device_tracker.paulus</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">家”</span><span class="na">然后</span><span class="pi">：</span><span class="c1">＃在此范围和序列的这一点上，人们== 0</span><span class="pi">-</span><span class="na">变量</span><span class="pi">：</span><span class="na">人们</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">人们</span><span class="nv"></span><span class="s">+</span><span class="nv"></span><span class="s">1</span><span class="nv"></span><span class="s">}}””</span><span class="c1">＃在此范围内，人们现在将是1 ...</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.notify</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">那里</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">{{</span><span class="nv"></span><span class="s">人们</span><span class="nv"></span><span class="s">}}}</span><span class="nv"></span><span class="s">人们</span><span class="nv"></span><span class="s">家”</span><span class="c1">＃“有1人家”</span><span class="c1">＃...但是在这个范围下它仍然是0</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.notify</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">那里</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">{{</span><span class="nv"></span><span class="s">人们</span><span class="nv"></span><span class="s">}}}</span><span class="nv"></span><span class="s">人们</span><span class="nv"></span><span class="s">家”</span><span class="c1">＃“有0人家”</span></code></pre> </div> </div> <h2><a class="title-link" name="test-a-condition" href="//www.jameselles.com/docs/scripts/#test-a-condition"></a>测试条件</h2> <p>在执行脚本时，您可以在主序列中添加条件以停止进一步执行。当条件不返回时<code>真的</code>，脚本将停止执行。有许多不同的条件在<Ahref="//www.jameselles.com/docs/docs/scripts/conditions/">条件页面</A>。</p> <div class="note"> <p>这<code>状况</code>动作仅停止执行当前序列块。当它在一个内部使用<Ahref="//www.jameselles.com/docs/scripts/#repeat-a-group-of-actions">重复</A>动作，只有当前的迭代<code>重复</code>循环将停止。当它在一个内部使用<Ahref="//www.jameselles.com/docs/scripts/#choose-a-group-of-actions">选择</A>行动，只有其中的行动<code>选择</code>会停止。</p> </div> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃如果保罗在家，请继续执行以下这些行的脚本</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">查看</span><span class="nv"></span><span class="s">如果</span><span class="nv"></span><span class="s">保卢斯</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">家”</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">device_tracker.paulus</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">家”</span></code></pre> </div> </div> <p><code>状况</code>也可以是条件的列表，而执行仅在所有条件返回时才继续<code>真的</code>。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">查看</span><span class="nv"></span><span class="s">如果</span><span class="nv"></span><span class="s">保卢斯</span><span class="nv"></span><span class="s">iShome</span><span class="nv"></span><span class="s">和</span><span class="nv"></span><span class="s">温度</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">以下</span><span class="nv"></span><span class="s">20”</span><span class="na">状况</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s2">“</span><span class="s">device_tracker.paulus”</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">家”</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">numeric_state</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s2">“</span><span class="s">传感器。</span><span class="na">以下</span><span class="pi">：</span><span class="m">20</span></code></pre> </div> </div> <h2><a class="title-link" name="wait-for-time-to-pass-delay" href="//www.jameselles.com/docs/scripts/#wait-for-time-to-pass-delay"></a>等待时间通过（延迟）</h2> <p>延迟对于暂时暂停您的脚本很有用并在以后的时刻开始。如下所示，我们支持延迟的不同语法。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃秒</span><span class="c1">＃等待5秒</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">等待</span><span class="nv"></span><span class="s">5s”</span><span class="na">延迟</span><span class="pi">：</span><span class="m">5</span></code></pre> </div> </div> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃HH：MM</span><span class="c1">＃等待1小时</span><span class="pi">-</span><span class="na">延迟</span><span class="pi">：</span><span class="s2">“</span><span class="s">01:00”</span></code></pre> </div> </div> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃HH：MM：SS</span><span class="c1">＃等待1.5分钟</span><span class="pi">-</span><span class="na">延迟</span><span class="pi">：</span><span class="s2">“</span><span class="s">00:01:30”</span></code></pre> </div> </div> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃支持毫秒，秒，分钟，小时，天数</span><span class="c1">＃可以组合使用，至少需要一个</span><span class="c1">＃等待1分钟</span><span class="pi">-</span><span class="na">延迟</span><span class="pi">：</span><span class="na">分钟</span><span class="pi">：</span><span class="m">1</span></code></pre> </div> </div> <p>所有表格都接受模板。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃等待多分钟input_number.minute_delay设置为</span><span class="pi">-</span><span class="na">延迟</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">状态（'input_number.minute_delay'）</span><span class="nv"></span><span class="s">|</span><span class="nv"></span><span class="s">乘以（60）</span><span class="nv"></span><span class="s">|</span><span class="nv"></span><span class="s">int</span><span class="nv"></span><span class="s">}}””</span></code></pre> </div> </div> <h2><a class="title-link" name="wait" href="//www.jameselles.com/docs/scripts/#wait"></a>等待</h2> <p>这些操作允许脚本等待系统中的实体处于模板指定的某个状态，或者某些事件发生的某些事件如一个或多个触发器所示。</p> <h3><a class="title-link" name="wait-for-a-template" href="//www.jameselles.com/docs/scripts/#wait-for-a-template"></a>等待模板</h3> <p>此操作评估模板，如果为true，则脚本将继续。如果不是，那么它将等到它是真的。</p> <p>每当它引用的实体ID更改状态时，该模板就会重新评估。如果您使用非确定性功能<code>现在（）</code>在模板中，它不会连续重新评估，而只有在更改引用的实体ID时才会进行重新评估。如果您需要定期重新评估模板，请从<Ahref="//www.jameselles.com/docs/integrations/time_date/">时间和日期</A>集成将详细更新或每天更新。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃等到媒体播放器停止</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">等待</span><span class="nv"></span><span class="s">直到</span><span class="nv"></span><span class="s">媒体</span><span class="nv"></span><span class="s">球员</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">停止”</span><span class="na">wait_template</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">IS_STATE（'Media_player.floor'，</span><span class="nv"></span><span class="s">'停止'）</span><span class="nv"></span><span class="s">}}””</span></code></pre> </div> </div> <h3><a class="title-link" name="wait-for-a-trigger" href="//www.jameselles.com/docs/scripts/#wait-for-a-trigger"></a>等待扳机</h3> <p>此操作可以使用自动化中可用的相同触发器<code>扳机</code>部分。看<Ahref="//www.jameselles.com/docs/docs/automation/trigger">自动化触发器</A>。每当触发任何触发器发射时，脚本都将继续。所有先前定义<Ahref="//www.jameselles.com/docs/docs/automation/trigger">触发变量</A>，，，，<Ahref="//www.jameselles.com/docs/scripts/#variables">变量</A>和<Ahref="//www.jameselles.com/docs/integrations/script/">脚本变量</A>被传递给扳机。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃等待自定义活动或灯光打开并保持10秒</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">等待</span><span class="nv"></span><span class="s">为了</span><span class="nv"></span><span class="s">my_event</span><span class="nv"></span><span class="s">或者</span><span class="nv"></span><span class="s">光</span><span class="nv"></span><span class="s">在”</span><span class="na">WAIT_FOR_TRIGGER</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">事件</span><span class="na">事件类型</span><span class="pi">：</span><span class="s">my_event</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">灯光</span><span class="na">到</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="na">为了</span><span class="pi">：</span><span class="m">10</span></code></pre> </div> </div> <h3><a class="title-link" name="wait-timeout" href="//www.jameselles.com/docs/scripts/#wait-timeout"></a>等待超时</h3> <p>通过两种类型的等待，都可以设置超时，然后如果不满足条件/事件，则脚本将继续执行。超时具有与<code>延迟</code>，喜欢<code>延迟</code>，也接受模板。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃等待传感器更改为“ ON”最多1分钟，然后继续执行。</span><span class="pi">-</span><span class="na">wait_template</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">is_state（'binary_sensor.entrance'，</span><span class="nv"></span><span class="s">'在'）</span><span class="nv"></span><span class="s">}}””</span><span class="na">暂停</span><span class="pi">：</span><span class="s2">“</span><span class="s">00:01:00”</span></code></pre> </div> </div> <p>您还可以使用可选<code>contine_on_timeout：false</code>。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃等待IFTTT事件或在指定超时后流产。</span><span class="pi">-</span><span class="na">WAIT_FOR_TRIGGER</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">事件</span><span class="na">事件类型</span><span class="pi">：</span><span class="s">iftt_webhook_received</span><span class="na">event_data</span><span class="pi">：</span><span class="na">行动</span><span class="pi">：</span><span class="s">connected_to_network</span><span class="na">暂停</span><span class="pi">：</span><span class="na">分钟</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">超时_minutes</span><span class="nv"></span><span class="s">}}””</span><span class="na">contine_on_timeout</span><span class="pi">：</span><span class="kc">错误的</span></code></pre> </div> </div> <p>没有<code>contine_on_timeout：false</code>脚本将始终继续，因为默认<code>contine_on_timeout</code>是<code>真的</code>。</p> <h3><a class="title-link" name="wait-variable" href="//www.jameselles.com/docs/scripts/#wait-variable"></a>等待变量</h3> <p>每次等待完成之后，要么是因为情况已经满足条件，事件发生了，或者超时到期，变量<code>等待</code>将创建/更新以指示结果。</p> <table> <thead> <tr> <th>多变的</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td><code>wait.com已完成</code></td> <td>只有之后才存在<code>wait_template</code>。<code>真的</code>如果情况满足，<code>错误的</code>否则</td> </tr> <tr> <td><code>等待。触发</code></td> <td>只有之后才存在<code>WAIT_FOR_TRIGGER</code>。包含有关触发的信息。（看<Ahref="//www.jameselles.com/docs/docs/automation/templating/">可用的触发数据</A>。）将<code>没有任何</code>如果超时到期之前没有触发</td> </tr> <tr> <td><code>等待</code></td> <td>剩下超时，或<code>没有任何</code>如果未指定超时</td> </tr> </tbody> </table> <p>这可以根据是否满足条件来采取不同的操作，或者在整体实现单个超时时使用多个等待。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃根据是否满足条件采取不同的行动。</span><span class="pi">-</span><span class="na">wait_template</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">IS_STATE（'Binary_sensor.door'，</span><span class="nv"></span><span class="s">'在'）</span><span class="nv"></span><span class="s">}}””</span><span class="na">暂停</span><span class="pi">：</span><span class="m">10</span><span class="pi">-</span><span class="na">如果</span><span class="pi">：</span><span class="pi">-</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">不是</span><span class="nv"></span><span class="s">wait.com已完成</span><span class="nv"></span><span class="s">}}””</span><span class="na">然后</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.door_did_not_open</span><span class="na">别的</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.turn_on</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="pi">-</span><span class="s">script.door_did_open</span><span class="pi">-</span><span class="s">script.play_fanfare</span><span class="c1">＃总共等待10秒。</span><span class="pi">-</span><span class="na">wait_template</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">IS_STATE（'Binary_sensor.door_1'，</span><span class="nv"></span><span class="s">'在'）</span><span class="nv"></span><span class="s">}}””</span><span class="na">暂停</span><span class="pi">：</span><span class="m">10</span><span class="na">contine_on_timeout</span><span class="pi">：</span><span class="kc">错误的</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">switch.turn_on</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">switch.some_light</span><span class="pi">-</span><span class="na">WAIT_FOR_TRIGGER</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">binary_sensor.door_2</span><span class="na">到</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="na">为了</span><span class="pi">：</span><span class="m">2</span><span class="na">暂停</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">等待</span><span class="nv"></span><span class="s">}}””</span><span class="na">contine_on_timeout</span><span class="pi">：</span><span class="kc">错误的</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">switch.turn_off</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">switch.some_light</span></code></pre> </div> </div> <h2><a class="title-link" name="fire-an-event" href="//www.jameselles.com/docs/scripts/#fire-an-event"></a>解雇活动</h2> <p>此操作使您可以解雇活动。事件可用于许多事情。它可能触发自动化或指示发生了什么事情正在发生的另一个集成。例如，在下面的示例中，它用于在日志中创建条目。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">火</span><span class="nv"></span><span class="s">logbook_entry</span><span class="nv"></span><span class="s">事件”</span><span class="na">事件</span><span class="pi">：</span><span class="s">logbook_entry</span><span class="na">event_data</span><span class="pi">：</span><span class="na">姓名</span><span class="pi">：</span><span class="s">保卢斯</span><span class="na">信息</span><span class="pi">：</span><span class="s">正在醒来</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">device_tracker.paulus</span><span class="na">领域</span><span class="pi">：</span><span class="s">光</span></code></pre> </div> </div> <p>您也可以使用Event_Data来发射具有自定义数据的事件。这可以用来将数据传递给另一个等待事件触发器的脚本。</p> <p>这<code>event_data</code>接受模板。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">事件</span><span class="pi">：</span><span class="s">my_event</span><span class="na">event_data</span><span class="pi">：</span><span class="na">姓名</span><span class="pi">：</span><span class="s">myevent</span><span class="na">定制</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">mycustomvaria</span><span class="nv"></span><span class="s">}}””</span></code></pre> </div> </div> <h3><a class="title-link" name="raise-and-consume-custom-events" href="//www.jameselles.com/docs/scripts/#raise-and-consume-custom-events"></a>提高和消费自定义活动</h3> <p>以下自动化示例显示了如何提出一个称为的自定义事件<code>event_light_state_changed</code>和<code>ENTITY_ID</code>作为事件数据。操作部分可以在脚本或自动化中。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">火</span><span class="nv"></span><span class="s">事件”</span><span class="na">扳机</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">switch.kitchen</span><span class="na">到</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="na">行动</span><span class="pi">：</span><span class="pi">-</span><span class="na">事件</span><span class="pi">：</span><span class="s">event_light_state_changed</span><span class="na">event_data</span><span class="pi">：</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span></code></pre> </div> </div> <p>以下自动化示例显示了如何捕获自定义事件<code>event_light_state_changed</code>与<Ahref="//www.jameselles.com/docs/docs/automation/trigger">事件自动化触发器</A>并检索相应的<code>ENTITY_ID</code>当事件触发数据时通过，请参阅<Ahref="//www.jameselles.com/docs/docs/automation/templating/">可用的触发数据</A>更多细节。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">捕获</span><span class="nv"></span><span class="s">事件”</span><span class="na">扳机</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">事件</span><span class="na">事件类型</span><span class="pi">：</span><span class="s">event_light_state_changed</span><span class="na">行动</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.notify</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">厨房</span><span class="nv"></span><span class="s">光</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">转身</span><span class="nv"></span><span class="s">{{</span><span class="nv"></span><span class="s">trigger.event.data.state</span><span class="nv"></span><span class="s">}}””</span></code></pre> </div> </div> <h2><a class="title-link" name="repeat-a-group-of-actions" href="//www.jameselles.com/docs/scripts/#repeat-a-group-of-actions"></a>重复一组动作</h2> <p>此操作使您可以重复一系列其他动作。筑巢得到充分支撑。有三种方法可以控制序列将运行多少次。</p> <h3><a class="title-link" name="counted-repeat" href="//www.jameselles.com/docs/scripts/#counted-repeat"></a>计数重复</h3> <p>此表格接受计数值。该值可以由模板指定，在这种情况下，在达到重复步骤时呈现模板。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">脚本</span><span class="pi">：</span><span class="na">手电筒</span><span class="pi">：</span><span class="na">模式</span><span class="pi">：</span><span class="s">重新开始</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_on</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s2">“</span><span class="s">光。{{</span><span class="nv"></span><span class="s">光</span><span class="nv"></span><span class="s">}}””</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">循环</span><span class="nv"></span><span class="s">光</span><span class="nv"></span><span class="s">'数数'</span><span class="nv"></span><span class="s">时代”</span><span class="na">重复</span><span class="pi">：</span><span class="na">数数</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">计数| int</span><span class="nv"></span><span class="s">*</span><span class="nv"></span><span class="s">2</span><span class="nv"></span><span class="s">-</span><span class="nv"></span><span class="s">1</span><span class="nv"></span><span class="s">}}””</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">延迟</span><span class="pi">：</span><span class="m">2</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.toggle</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s2">“</span><span class="s">光。{{</span><span class="nv"></span><span class="s">光</span><span class="nv"></span><span class="s">}}””</span><span class="na">flash_hallway_light</span><span class="pi">：</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">闪光</span><span class="nv"></span><span class="s">门厅</span><span class="nv"></span><span class="s">光</span><span class="nv"></span><span class="s">3</span><span class="nv"></span><span class="s">时代”</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.flash_light</span><span class="na">数据</span><span class="pi">：</span><span class="na">光</span><span class="pi">：</span><span class="s">门厅</span><span class="na">数数</span><span class="pi">：</span><span class="m">3</span></code></pre> </div> </div> <h3><a class="title-link" name="for-each" href="//www.jameselles.com/docs/scripts/#for-each"></a>每个</h3> <p>此重复表格接受迭代的项目列表。项目列表可以是预定义的列表，也可以是模板创建的列表。</p> <p>该序列是针对列表中的每个项目运行的，并且迭代中的当前项目可用于<code>重复项目</code>。</p> <p>下面的示例将变成灯光列表：</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">重复</span><span class="pi">：</span><span class="na">for_each</span><span class="pi">：</span><span class="pi">-</span><span class="s2">“</span><span class="s">客厅”</span><span class="pi">-</span><span class="s2">“</span><span class="s">厨房”</span><span class="pi">-</span><span class="s2">“</span><span class="s">办公室”</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_off</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s2">“</span><span class="s">光。{{</span><span class="nv"></span><span class="s">重复项目</span><span class="nv"></span><span class="s">}}””</span></code></pre> </div> </div> <p>其他类型被接受为列表项目，例如，每个项目都可以是模板，甚至可以是密钥/值对的映射。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">重复</span><span class="pi">：</span><span class="na">for_each</span><span class="pi">：</span><span class="pi">-</span><span class="na">语言</span><span class="pi">：</span><span class="s">英语</span><span class="na">信息</span><span class="pi">：</span><span class="s">你好世界</span><span class="pi">-</span><span class="na">语言</span><span class="pi">：</span><span class="s">荷兰</span><span class="na">信息</span><span class="pi">：</span><span class="s">哈罗·韦尔德（Hallo Wereld）</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">通知电话</span><span class="na">数据</span><span class="pi">：</span><span class="na">标题</span><span class="pi">：</span><span class="s2">“</span><span class="s">信息</span><span class="nv"></span><span class="s">在</span><span class="nv"></span><span class="s">{{</span><span class="nv"></span><span class="s">重复。语言</span><span class="nv"></span><span class="s">}}””</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">重复</span><span class="nv"></span><span class="s">}}}！”</span></code></pre> </div> </div> <h3><a class="title-link" name="while-loop" href="//www.jameselles.com/docs/scripts/#while-loop"></a>循环</h3> <p>此表格接受条件列表（请参阅<Ahref="//www.jameselles.com/docs/docs/scripts/conditions/">条件页面</A>有关可用选项）<em>前</em>每次运行序列。序列将运行<em>只要</em>条件评估为true。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">脚本</span><span class="pi">：</span><span class="na">做一点事</span><span class="pi">：</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.get_ready_for_something</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">重复</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">顺序</span><span class="nv"></span><span class="s">作为</span><span class="nv"></span><span class="s">长的</span><span class="nv"></span><span class="s">作为</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">状况</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">真的”</span><span class="na">重复</span><span class="pi">：</span><span class="na">尽管</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">input_boolean.do_something</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="c1">＃不要做太多次</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">模板</span><span class="na">value_template</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">重复。索引</span><span class="nv"></span><span class="s"><=</span><span class="nv"></span><span class="s">20</span><span class="nv"></span><span class="s">}}””</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">脚本</span></code></pre> </div> </div> <p>这<code>尽管</code>也接受<Ahref="//www.jameselles.com/docs/docs/scripts/conditions/">模板条件的速记符号</A>。例如：</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">重复</span><span class="pi">：</span><span class="na">尽管</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">is_state（'sensor.mode'，</span><span class="nv"></span><span class="s">'家'）</span><span class="nv"></span><span class="s">和</span><span class="nv"></span><span class="s">重复。索引</span><span class="nv"></span><span class="s"><</span><span class="nv"></span><span class="s">10</span><span class="nv"></span><span class="s">}}””</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="s">...</span></code></pre> </div> </div> <h3><a class="title-link" name="repeat-until" href="//www.jameselles.com/docs/scripts/#repeat-until"></a>重复直到</h3> <p>此表格接受评估的条件列表<em>后</em>每次运行序列。因此，序列总是至少运行一次。序列将运行<em>直到</em>条件评估为true。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">自动化</span><span class="pi">：</span><span class="pi">-</span><span class="na">扳机</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">binary_sensor.xyz</span><span class="na">到</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="na">状况</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">binary_sensor.something</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">离开”</span><span class="na">模式</span><span class="pi">：</span><span class="s">单身的</span><span class="na">行动</span><span class="pi">：</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">重复</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">顺序</span><span class="nv"></span><span class="s">直到</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">状况</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">真的”</span><span class="na">重复</span><span class="pi">：</span><span class="na">顺序</span><span class="pi">：</span><span class="c1">＃运行命令出于某种原因并不总是有效</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">shell_command.turn_something_on</span><span class="c1">＃给它时间完成</span><span class="pi">-</span><span class="na">延迟</span><span class="pi">：</span><span class="na">毫秒</span><span class="pi">：</span><span class="m">200</span><span class="na">直到</span><span class="pi">：</span><span class="c1">＃它可以工作吗？</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">binary_sensor.something</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span></code></pre> </div> </div> <p><code>直到</code>也接受<Ahref="//www.jameselles.com/docs/docs/scripts/conditions/">模板条件的速记符号</A>。例如：</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">重复</span><span class="pi">：</span><span class="na">直到</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">IS_STATE（'device_tracker.iphone'，</span><span class="nv"></span><span class="s">'家'）</span><span class="nv"></span><span class="s">}}””</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="s">...</span></code></pre> </div> </div> <h3><a class="title-link" name="repeat-loop-variable" href="//www.jameselles.com/docs/scripts/#repeat-loop-variable"></a>重复循环变量</h3> <p>一个命名的变量<code>重复</code>在重复操作中定义（即，内部可用<code>顺序</code>，，，，<code>尽管</code>和<code>直到</code>。）它包含以下字段：</p> <table> <thead> <tr> <th>场地</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td><code>第一的</code></td> <td>在重复序列的第一次迭代中为</td> </tr> <tr> <td><code>指数</code></td> <td>循环的迭代编号：1，2，3，…</td> </tr> <tr> <td><code>最后的</code></td> <td>在重复序列的最后一次迭代期间，仅对计数循环有效</td> </tr> </tbody> </table> <h2><a class="title-link" name="if-then" href="//www.jameselles.com/docs/scripts/#if-then"></a>如果然后</h2> <p>此操作使您有条件地（<code>如果</code>）执行一系列动作（<code>然后</code>）并在条件未通过时可选地支持运行其他序列（<code>别的</code>）。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">脚本</span><span class="pi">：</span><span class="pi">-</span><span class="na">如果</span><span class="pi">：</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">如果</span><span class="nv"></span><span class="s">不</span><span class="nv"></span><span class="s">一</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">家”</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">区域</span><span class="na">状态</span><span class="pi">：</span><span class="m">0</span><span class="na">然后</span><span class="pi">：</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">然后</span><span class="nv"></span><span class="s">开始</span><span class="nv"></span><span class="s">打扫</span><span class="nv"></span><span class="s">已经！”</span><span class="na">服务</span><span class="pi">：</span><span class="s">真空</span><span class="na">目标</span><span class="pi">：</span><span class="na">aket_id</span><span class="pi">：</span><span class="s">客厅</span><span class="c1">＃“ else”是完全可选的，可以省略</span><span class="na">别的</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.notify</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">跳过</span><span class="nv"></span><span class="s">打扫，</span><span class="nv"></span><span class="s">有人</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">家！”</span></code></pre> </div> </div> <p>但是，此操作支持筑巢，如果您发现自己在使用嵌套时，<code>别的</code>部分，您可能需要考虑使用<Ahref="//www.jameselles.com/docs/scripts/#choose-a-group-of-actions">选择</A>反而。</p> <h2><a class="title-link" name="choose-a-group-of-actions" href="//www.jameselles.com/docs/scripts/#choose-a-group-of-actions"></a>选择一组动作</h2> <p>此操作使您可以从序列列表中选择其他动作序列。筑巢得到充分支撑。</p> <p>每个序列与条件列表配对。（请参阅<Ahref="//www.jameselles.com/docs/docs/scripts/conditions/">条件页面</A>对于可用的选项以及如何处理多个条件。）第一个条件都是正确的序列。一个<em>选修的</em><code>默认</code>可以包括序列，只有运行列表中的序列都没有运行，才能运行。</p> <p>一个<em>选修的</em><code>别名</code>可以添加到每个序列中，不包括<code>默认</code>顺序。</p> <p>这<code>选择</code>操作可以像“如果/then/elseif/then…/else”语句一样使用。首先<code>状况</code>/<code>顺序</code>一对就像“如果/then”，可以单独使用。或可以添加其他对，每对都像“ elif/then”。最后，一个<code>默认</code>可以添加，就像“否则”。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃带有“ if”，“ elif”和“ else”的示例</span><span class="na">自动化</span><span class="pi">：</span><span class="pi">-</span><span class="na">扳机</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">input_boolean.simulate</span><span class="na">到</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="na">模式</span><span class="pi">：</span><span class="s">重新开始</span><span class="na">行动</span><span class="pi">：</span><span class="pi">-</span><span class="na">选择</span><span class="pi">：</span><span class="c1">＃如果早上</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">模板</span><span class="na">value_template</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">现在（）。小时</span><span class="nv"></span><span class="s"><</span><span class="nv"></span><span class="s">9</span><span class="nv"></span><span class="s">}}””</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.sim_morning</span><span class="c1">＃Elif Day</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">模板</span><span class="na">value_template</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">现在（）。小时</span><span class="nv"></span><span class="s"><</span><span class="nv"></span><span class="s">18</span><span class="nv"></span><span class="s">}}””</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_off</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">light.living_room</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.sim_day</span><span class="c1">＃否则晚上</span><span class="na">默认</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_off</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">Light.Kitchen</span><span class="pi">-</span><span class="na">延迟</span><span class="pi">：</span><span class="na">分钟</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">范围（1，</span><span class="nv"></span><span class="s">11）|随机</span><span class="nv"></span><span class="s">}}””</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_off</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">全部</span></code></pre> </div> </div> <p><code>状况</code>也接受<Ahref="//www.jameselles.com/docs/docs/scripts/conditions/">模板条件的速记符号</A>。例如：</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">自动化</span><span class="pi">：</span><span class="pi">-</span><span class="na">扳机</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">input_select.home_mode</span><span class="na">行动</span><span class="pi">：</span><span class="pi">-</span><span class="na">选择</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="pi">></span><span class="s">{{trigger.to_state.state =='home'和</span><span class="s">IS_STATE（'Binary_sensor.all_clear'，'on'）}}}</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.arrive_home</span><span class="na">数据</span><span class="pi">：</span><span class="na">好的</span><span class="pi">：</span><span class="kc">真的</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="pi">></span><span class="s">{{trigger.to_state.state =='home'和</span><span class="s">is_state（'binary_sensor.all_clear'，'off'）}}}</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.turn_on</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">script.flash_lights</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.arrive_home</span><span class="na">数据</span><span class="pi">：</span><span class="na">好的</span><span class="pi">：</span><span class="kc">错误的</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s2">“</span><span class="s">{{</span><span class="nv"></span><span class="s">trigger.to_state.state</span><span class="nv"></span><span class="s">==</span><span class="nv"></span><span class="s">'离开'</span><span class="nv"></span><span class="s">}}””</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">script.left_home</span></code></pre> </div> </div> <p>更多的<code>选择</code>可以一起使用。if-if就是这种情况。</p> <p>下面的示例显示了单个自动化如何控制与彼此无关但共同触发的实体。</p> <p>当太阳在地平线以下时<code>门廊</code>和<code>花园</code>灯必须打开。如果有人在客厅里看电视，那么有人很有可能在那个房间里，因此客厅的灯光也必须打开。同样的概念适用于<code>工作室</code>房间。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃带有“ if”和“ if”的示例</span><span class="na">自动化</span><span class="pi">：</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">转动</span><span class="nv"></span><span class="s">灯</span><span class="nv"></span><span class="s">在</span><span class="nv"></span><span class="s">什么时候</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">太阳</span><span class="nv"></span><span class="s">得到</span><span class="nv"></span><span class="s">暗淡</span><span class="nv"></span><span class="s">和</span><span class="nv"></span><span class="s">如果</span><span class="nv"></span><span class="s">一些</span><span class="nv"></span><span class="s">房间</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">占据”</span><span class="na">扳机</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">numeric_state</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">太阳</span><span class="na">属性</span><span class="pi">：</span><span class="s">海拔</span><span class="na">以下</span><span class="pi">：</span><span class="m">4</span><span class="na">行动</span><span class="pi">：</span><span class="c1">＃这必须始终适用</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_on</span><span class="na">数据</span><span class="pi">：</span><span class="na">亮度</span><span class="pi">：</span><span class="m">255</span><span class="na">color_temp</span><span class="pi">：</span><span class="m">366</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="pi">-</span><span class="s">Light.porch</span><span class="pi">-</span><span class="s">Light.Garden</span><span class="c1">＃如果实体正在打开</span><span class="pi">-</span><span class="na">选择</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">binary_sensor.livingroom_tv</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_on</span><span class="na">数据</span><span class="pi">：</span><span class="na">亮度</span><span class="pi">：</span><span class="m">255</span><span class="na">color_temp</span><span class="pi">：</span><span class="m">366</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">灯光</span><span class="c1">＃如果另一个与上一个无关的实体正在打开</span><span class="pi">-</span><span class="na">选择</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="pi">-</span><span class="na">状况</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">binary_sensor.studio_pc</span><span class="na">状态</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_on</span><span class="na">数据</span><span class="pi">：</span><span class="na">亮度</span><span class="pi">：</span><span class="m">255</span><span class="na">color_temp</span><span class="pi">：</span><span class="m">366</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">Light.Studio</span></code></pre> </div> </div> <h2><a class="title-link" name="parallelizing-actions" href="//www.jameselles.com/docs/scripts/#parallelizing-actions"></a>并行操作</h2> <p>默认情况下，家庭助理中的所有操作序列顺序运行。必威是什么这意味着在当前动作完成后开始下一个动作。</p> <p>例如，如果动作顺序不依赖彼此并且订单无关紧要，那么这并不总是需要。对于这些情况，<code>平行线</code>动作可用于并行地以序列进行操作，这意味着所有动作均同时启动。</p> <p>以下示例显示同时发送消息（并行）：</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">自动化</span><span class="pi">：</span><span class="pi">-</span><span class="na">扳机</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">binary_sensor.motion</span><span class="na">到</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="na">行动</span><span class="pi">：</span><span class="pi">-</span><span class="na">平行线</span><span class="pi">：</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.person1</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">这些</span><span class="nv"></span><span class="s">消息</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">发送</span><span class="nv"></span><span class="s">在</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">相同的</span><span class="nv"></span><span class="s">时间！”</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.person2</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">这些</span><span class="nv"></span><span class="s">消息</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">发送</span><span class="nv"></span><span class="s">在</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">相同的</span><span class="nv"></span><span class="s">时间！”</span></code></pre> </div> </div> <p>也可以在并行操作中依次运行一组动作。下面的示例表明：</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="na">脚本</span><span class="pi">：</span><span class="na">example_script</span><span class="pi">：</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">平行线</span><span class="pi">：</span><span class="pi">-</span><span class="na">顺序</span><span class="pi">：</span><span class="pi">-</span><span class="na">WAIT_FOR_TRIGGER</span><span class="pi">：</span><span class="pi">-</span><span class="na">平台</span><span class="pi">：</span><span class="s">状态</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">binary_sensor.motion</span><span class="na">到</span><span class="pi">：</span><span class="s2">“</span><span class="s">在”</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.person1</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">这</span><span class="nv"></span><span class="s">信息</span><span class="nv"></span><span class="s">等待</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">运动</span><span class="nv"></span><span class="s">扳机”</span><span class="pi">-</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.person2</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">我</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">发送</span><span class="nv"></span><span class="s">立即地</span><span class="nv"></span><span class="s">和</span><span class="nv"></span><span class="s">做</span><span class="nv"></span><span class="s">不是</span><span class="nv"></span><span class="s">等待</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">多于</span><span class="nv"></span><span class="s">行动！”</span></code></pre> </div> </div> <div class="note"> <p>在许多情况下，并行运行动作可能会有所帮助，但要谨慎使用，并且只有在需要时才使用。</p> <p>使用并行动作时，有一些警告（请参见下文）。</p> <p>尽管在大多数情况下听起来并行化听起来很有吸引力，但只有常规顺序动作才能正常工作。</p> </div> <p>并行运行动作的一些警告：</p> <ul> <li>没有订单保证。这些动作将并行启动，但不能保证它们将按照相同的顺序完成。</li> <li>如果一个动作失败或错误，另一个动作将继续运行，直到它们也完成或错误为止。</li> <li>在另一个并行操作中无法使用一个并行操作中创建/修改的变量。并行的每个步骤都有自己的范围。</li> </ul> <h2><a class="title-link" name="stopping-a-script-sequence" href="//www.jameselles.com/docs/scripts/#stopping-a-script-sequence"></a>停止脚本序列</h2> <p>任何时候都可以停止脚本序列。使用<code>停止</code>行动。</p> <p>这<code>停止</code>动作将文本作为输入说明停止序列的原因。该文本将被记录并显示在自动化和脚本痕迹中。</p> <p><code>停止</code>例如，如果不满足条件，则可以在序列中途停止脚本。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">停止</span><span class="pi">：</span><span class="s2">“</span><span class="s">停止</span><span class="nv"></span><span class="s">跑步</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">休息</span><span class="nv"></span><span class="s">的</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">顺序”</span></code></pre> </div> </div> <p>还有一个<code>错误</code>选项，指示我们由于出乎意料的错误而停止。它也停止了序列，但是将自动化或脚本标记为无法运行的。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">停止</span><span class="pi">：</span><span class="s2">“</span><span class="s">出色地，</span><span class="nv"></span><span class="s">那</span><span class="nv"></span><span class="s">曾是</span><span class="nv"></span><span class="s">意外！”</span><span class="na">错误</span><span class="pi">：</span><span class="kc">真的</span></code></pre> </div> </div> <h2><a class="title-link" name="continuing-on-error" href="//www.jameselles.com/docs/scripts/#continuing-on-error"></a>继续错误</h2> <p>默认情况下，当该序列中的操作之一遇到错误时，将停止操作序列。自动化或脚本将停止，记录错误，并且自动化或脚本运行标记为错误。</p> <p>有时候，这些错误是可以预期的，例如，因为您知道您致电的服务有时可能会出现问题，并且失败都没关系。您可以设置<code>继续_on_error</code>对于这种行动的情况。</p> <p>这<code>继续_on_error</code>可在所有操作中可用，并设置为<code>错误的</code>。您可以将其设置为<code>真的</code>如果您想继续操作序列，那么无论该动作是否遇到错误。</p> <p>下面的示例显示了<code>继续_on_error</code>设置第一个动作。如果遇到错误；它将继续采取下一个动作。</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">如果</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">一</span><span class="nv"></span><span class="s">失败...”</span><span class="na">继续_on_error</span><span class="pi">：</span><span class="kc">真的</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.super_unreliable_service_provider</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">我是</span><span class="nv"></span><span class="s">去</span><span class="nv"></span><span class="s">到</span><span class="nv"></span><span class="s">错误</span><span class="nv"></span><span class="s">出去...”</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">这</span><span class="nv"></span><span class="s">一</span><span class="nv"></span><span class="s">将要</span><span class="nv"></span><span class="s">仍然</span><span class="nv"></span><span class="s">跑步！”</span><span class="na">服务</span><span class="pi">：</span><span class="s">persistent_notification.greate</span><span class="na">数据</span><span class="pi">：</span><span class="na">标题</span><span class="pi">：</span><span class="s2">“</span><span class="s">你好</span><span class="nv"></span><span class="s">那里！”</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">我是</span><span class="nv"></span><span class="s">美好的...”</span></code></pre> </div> </div> <p>请注意<code>继续_on_error</code>不会抑制/忽略家庭助手无法处理的错误或错误。必威是什么</p> <h2><a class="title-link" name="disabling-an-action" href="//www.jameselles.com/docs/scripts/#disabling-an-action"></a>禁用行动</h2> <p>序列中的每个单独操作都可以禁用，而无需删除。为此，添加<code>启用：false</code>采取行动。例如：</p> <div class="language-yaml highlighter-rouge"> <div class="highlight"> <pre class="highlight"><code data-lang="yaml"><span class="c1">＃带有禁用动作的示例脚本</span><span class="na">脚本</span><span class="pi">：</span><span class="na">example_script</span><span class="pi">：</span><span class="na">顺序</span><span class="pi">：</span><span class="c1">＃由于禁用了此操作，因此不会运行。</span><span class="c1">＃该消息将不会发送。</span><span class="pi">-</span><span class="na">启用</span><span class="pi">：</span><span class="kc">错误的</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">通知</span><span class="nv"></span><span class="s">那</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">天花板</span><span class="nv"></span><span class="s">光</span><span class="nv"></span><span class="s">是</span><span class="nv"></span><span class="s">存在</span><span class="nv"></span><span class="s">转身</span><span class="nv"></span><span class="s">在”</span><span class="na">服务</span><span class="pi">：</span><span class="s">notify.notify</span><span class="na">数据</span><span class="pi">：</span><span class="na">信息</span><span class="pi">：</span><span class="s2">“</span><span class="s">转身</span><span class="nv"></span><span class="s">在</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">天花板</span><span class="nv"></span><span class="s">光！”</span><span class="c1">＃此操作将运行，因为它没有禁用</span><span class="pi">-</span><span class="na">别名</span><span class="pi">：</span><span class="s2">“</span><span class="s">转动</span><span class="nv"></span><span class="s">在</span><span class="nv"></span><span class="s">这</span><span class="nv"></span><span class="s">天花板</span><span class="nv"></span><span class="s">光”</span><span class="na">服务</span><span class="pi">：</span><span class="s">light.turn_on</span><span class="na">目标</span><span class="pi">：</span><span class="na">ENTITY_ID</span><span class="pi">：</span><span class="s">光线</span></code></pre> </div> </div> <div class="material-card text feedback" id="feedback_section"> <h4><a href="//www.jameselles.com/docs/scripts/#feedback_section" class="title-link"><b>帮助我们改善文档</b></a></h4>建议对此页面进行编辑，或为此页面提供/查看反馈。<div class="links"> <a href="https://github.com/home-assistant/home-assistant.github.io/tree/current/source/_docs/scripts.markdown" target="_blank" rel="external nofollow"><i class="icon-edit"></i>编辑</A><Ahref="https://github.com/home-assistant/home-assistant.github.io/issues/new?template=feedback.yml&url=https%3A%2F%2Fwww.jameselles.com%2Fdocs%2Fscripts%2F&version=2023.5.3&labels=current" target="_blank" rel="external nofollow"><i class="icon-comment"></i>提供反馈信息</A><Ahref="https://github.com/home-assistant/home-assistant.github.io/issues?utf8=%E2%9C%93&q=%22%2Fdocs%2Fscripts%2F%22&in=body" target="_blank" rel="external nofollow"><i class="icon-comments"></i>查看给定的反馈</A></div> </div> </article> </div> <aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole"> <div class="grid"> <section class="aside-module grid__item one-whole lap-one-half"> <div class="section"> <h1 class="title delta">主题</h1> <ul class="divided sidebar-menu"> <li><b><a href="//www.jameselles.com/docs/faq/">常问问题</A></b>|<b><a href="//www.jameselles.com/docs/docs/glossary/">词汇表</A></b></li> <li><b><a href="//www.jameselles.com/docs/getting-started">入门</A></b> <ul> <li><a href="//www.jameselles.com/docs/installation">安装</A></li> <li><a href="//www.jameselles.com/docs/common-tasks/os/">常见任务</A></li> <li><a href="//www.jameselles.com/docs/docs/troubleshooting/">故障排除</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/configuration/">configuration.yaml</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/configuration/yaml/">yaml</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/basic/">基本信息</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/customizing-devices/">定制实体</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/troubleshooting/">故障排除</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/securing/">安全检查点</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/assist/">协助</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/assist/android/">协助Android</A></li> <li><a href="//www.jameselles.com/docs/docs/assist/apple/">协助苹果设备</A></li> <li><a href="//www.jameselles.com/docs/docs/assist/builtin_sentences/">内置句子</A></li> <li><a href="//www.jameselles.com/docs/docs/assist/custom_sentences/">自定义句子</A></li> <li><a href="//www.jameselles.com/docs/docs/assist/using_voice_assistants_overview/">语音助手 - 概述</A></li> <li><a href="//www.jameselles.com/docs/docs/assist/voice_remote_expose_devices/">将设备暴露给您的语音助手</A></li> <li><a href="//www.jameselles.com/docs/docs/assist/voice_remote_local_assistant/">配置本地助手</A></li> <li><a href="//www.jameselles.com/docs/docs/assist/troubleshooting/">故障排除辅助</A></li> <li><a href="//www.jameselles.com/docs/projects/worlds-most-private-voice-assistant/">教程：世界上最私人的助手</A></li> <li><a href="//www.jameselles.com/docs/projects/thirteen-usd-voice-remote/">教程：$ 13的语音遥控</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/energy/">家庭能源管理</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/energy/electricity-grid/">电网</A></li> <li><a href="//www.jameselles.com/docs/docs/energy/solar-panels/">太阳能板</A></li> <li><a href="//www.jameselles.com/docs/docs/energy/individual-devices/">单个设备</A></li> <li><a href="//www.jameselles.com/docs/docs/energy/faq/">常问问题</A></li> </ul></li> <li>高级配置<ul> <li><a href="//www.jameselles.com/docs/docs/configuration/remote/">远程访问</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/splitting_configuration/">分开配置</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/packages/">软件包</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/secrets/">存储秘密</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/templating/">模板</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/platform_options/">实体组件平台选项</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/authentication/">验证</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/authentication/providers/">身份提供者</A></li> <li><a href="//www.jameselles.com/docs/docs/authentication/multi-factor-auth/">多因素auth</A></li> </ul></li> <li>核心对象<ul> <li><a href="//www.jameselles.com/docs/docs/configuration/events/">事件</A></li> <li><a href="//www.jameselles.com/docs/docs/configuration/state_object/">状态对象</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/automation/">自动化</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/automation/using_blueprints/">使用自动化蓝图</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/basics/">自动化基础</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/editor/">编辑</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/trigger/">触发器</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/condition/">状况</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/action/">动作</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/modes/">运行模式</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/services/">服务</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/templating/">模板</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/yaml/">yaml</A></li> <li><a href="//www.jameselles.com/docs/docs/automation/troubleshooting/">故障排除</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/blueprint/">蓝图</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/blueprint/tutorial/">教程</A></li> <li><a href="//www.jameselles.com/docs/docs/blueprint/schema/">模式</A></li> <li><a href="//www.jameselles.com/docs/docs/blueprint/selectors/">选择器</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/frontend/">前端</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/frontend/browsers/">浏览器兼容性列表</A></li> <li><a href="//www.jameselles.com/docs/dashboards">仪表板</A></li> <li><a href="//www.jameselles.com/docs/docs/frontend/icons/">图标</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/backend/">后端</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/backend/database/">数据库</A></li> </ul></li> <li><b><a class="active" href="//www.jameselles.com/docs/docs/scripts/">脚本</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/scripts/service-calls/">服务电话</A></li> <li><a href="//www.jameselles.com/docs/docs/scripts/conditions/">状况</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/scene/">场景</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/scene/editor/">编辑</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/docs/tools/">工具和助手</A></b> <ul> <li><a href="//www.jameselles.com/docs/docs/tools/dev-tools/">开发者工具</A></li> <li><a href="//www.jameselles.com/docs/docs/tools/quick-bar/">快速酒吧</A></li> <li><a href="//www.jameselles.com/docs/docs/tools/hass/">哈斯</A></li> <li><a href="//www.jameselles.com/docs/docs/tools/check_config/">check_config</A></li> </ul></li> <li><b><a href="//www.jameselles.com/docs/integrations/mqtt">mqtt</A></b> <ul> <li><a href="//www.jameselles.com/docs/integrations/mqtt/">经纪人</A></li> <li><a href="//www.jameselles.com/docs/integrations/mqtt/">证书</A></li> <li><a href="//www.jameselles.com/docs/integrations/mqtt/">发现</A></li> <li><a href="//www.jameselles.com/docs/integrations/mqtt/">发布服务</A></li> <li><a href="//www.jameselles.com/docs/integrations/mqtt/">出生和最后一条消息</A></li> <li><a href="//www.jameselles.com/docs/integrations/mqtt/">测试您的设置</A></li> <li><a href="//www.jameselles.com/docs/integrations/mqtt/">记录</A></li> </ul></li> <li><b>硬件</b> <ul> <li><a href="//www.jameselles.com/yellow/">必威是什么家庭助理黄色</A></li> <li><a href="//www.jameselles.com/skyconnect/">必威是什么家用助理SkyConnect</A></li> </ul></li> </ul> </div> </section> </div> </aside> </div> </div> <footer> <div class="grid-wrapper"> <div class="grid"> <div class="grid__item"> <div class="copyright grid"> <div class="company grid__item one-third lap-one-half palm-one-whole"> <div class="title"> <img width="40" src="//www.jameselles.com/docs/images/favicon-192x192-full.png" alt="必威是什么">必威是什么 </div> <div class="icons"> <a rel="me" href="https://twitter.com/home_assistant" title=""><i class="icon-twitter"></i></a> <a rel="me" href="https://www.facebook.com/homeassistantio" title=""><i class="icon-facebook"></i></a> <a rel="me" href="https://github.com/home-assistant/core" title=""><i class="icon-github"></i></a> </div> </div> <div class="grid__item one-third lap-one-half palm-one-whole"> <ul> <li><a href="//www.jameselles.com/alerts">betway电竞登陆</a></li> <li><a href="//www.jameselles.com/developers">开发人员</A></li> <li><a href="//www.jameselles.com/data">数据科学</A></li> <li><a href="//www.jameselles.com/community">社区论坛</A></li> <li><a href="//www.jameselles.com/docs/cdn-cgi/l/email-protection">接触</A>（没有支持！）</li> <li><a href="//www.jameselles.com/docs/security/">安全漏洞</A></li> <li><a href="//www.jameselles.com/docs/privacy/">隐私</A></li> <li><a href="//www.jameselles.com/status">系统状况</A></li> </ul> </div> <div class="grid__item one-third lap-one-half palm-one-whole"> 网站由<Ahref="https://jekyllrb.com/">杰基</A>和<Ahref="https://github.com/coogie/oscailte">Oscailte主题</A>。<br> <br> <a href="https://www.netlify.com"><img src="//www.jameselles.com/docs/images/frontpage/netlify.svg" alt="通过Netlify徽章部署“></A></div> </div> </div> </div> </div> </footer> </div> <link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/2/docsearch.min.css"> <div style="text-align:center;margin-bottom:5px;"><form action="http://www.baidu.com/baidu" target="_blank"><div bgcolor="#FFFFFF" style="text-align:center;"><input name="tn" type="hidden" value="baidu"><a href="http://www.baidu.com/"><img src="http://img.baidu.com/img/logo-80px.gif" width="80px" height="29px" alt="Baidu" align="bottom" border="0"></a><input type="text" name="word" size="30" placeholder="" value=""><input type="submit" value="百度搜索"></div></form></div><div id="so360" style="text-align:center;margin-bottom:5px;"><form action="https://www.so.com/" target="_blank" id="so360form"><img src="http://p1.qhimg.com/d/_onebox/search.png" width="100px" height="25px"> <input type="text" autocomplete="off" name="q" id="so360_keyword" placeholder="" value=""> <input type="submit" id="so360_submit" value="360搜索"> <input type="hidden" name="ie" value="gbk"><input type="hidden" name="src" value="zz"> <input type="hidden" name="site" value="so.com"> <input type="hidden" name="rg" value="1"></form></div><div id="sogou" style="text-align:center;margin-bottom:5px;"><form action="https://www.sogou.com/" target="_blank" id="so360form"><img src="https://www.sogou.com/web/index/images/logo_440x140.v.4.png" width="100px" height="25px"> <input type="text" autocomplete="off" name="q" id="sogou.com_keyword" placeholder="" value=""> <input type="submit" id="sogou_submit" value="搜狗"> <input type="hidden" name="ie" value="gbk"><input type="hidden" name="src" value="zz"> <input type="hidden" name="site" value="so.com"> <input type="hidden" name="rg" value="1"></form></div></body> </html>