סימנים לתחילת פעולות, תנאים ופעולות נתמכים

מערכות אוטומטיות תומכות בפעולות ובסימנים הבאים לתחילת פעולה. כל המצבים נתמכים גם כתנאים.

מצב / אירוע (סימן לתחילת פעולה)
תנאי
פקודה (פעולה)		 שדות נתמכים תיאור
‫and תנאי מורכב שמייצג את האופרטור הלוגי AND של כל תנאי הצאצא.
‫assistant.command.Broadcast הודעה
assistant.command.OkGoogle okGoogle
‫assistant.event.OkGoogle שאילתה
‫device.command.ActivateScene הפעלה מפעילים או משביתים סצנה.
‫device.command.AppInstall newApplicationName התקנת אפליקציה במכשיר הנתון.
‫device.command.AppSearch applicationName מחפשים את האפליקציה שצוינה.
device.command.AppSelect applicationName בוחרים את האפליקציה הרלוונטית.
device.command.ArmDisarm arm
armLevel
cancel		 מגדירים את רמת ההתראה של המכשיר.
‫device.command.BrightnessAbsolute בהירות שינוי הבהירות המוחלטת של המכשיר. אם הבהירות מוגדרת לערך כלשהו שגדול מ-0, והמכשיר כבוי, המכשיר מופעל והערך של [`OnOffState.state`](./on_off_state) משתנה כדי לשקף שהמכשיר פועל. באופן דומה, כשהבהירות מוגדרת ל-0, המכשיר מושבת והערך של [`OnOffState.state`](./on_off_state) משתנה בהתאם.
device.command.BrightnessRelative brightnessRelativePercent
brightnessRelativeWeight		 שינוי הבהירות היחסית של המכשיר. אם הבהירות מוגדרת לערך כלשהו שגדול מ-0, והמכשיר כבוי, המכשיר מופעל והערך של [`OnOffState.state`](./on_off_state) משתנה כדי לשקף שהמכשיר פועל. באופן דומה, כשהבהירות מוגדרת ל-0, המכשיר מושבת והערך של [`OnOffState.state`](./on_off_state) משתנה בהתאם.
‫device.command.Charge חיוב התחלה או הפסקה של הטעינה.
device.command.ColorAbsolute ‫color.name
color.spectrumHSV.hue
color.spectrumHSV.saturation
color.spectrumHSV.value
color.spectrumRGB
color.temperature		 מגדיר את הצבע לגוון שצוין. אם הצבע מוגדר במכשיר כבוי, המכשיר מופעל והערך של [‎`OnOffState.state`](./on_off_state) משתנה בהתאם. באופן דומה, אם הבהירות מוגדרת ל-0, המכשיר מושבת והערך של [‎`OnOffState.state`](./on_off_state) משתנה בהתאם.
‫device.command.Cook cookingMode
foodPreset
quantity
start
unit		 להתחיל או להפסיק לבשל.
device.command.Dispense amount
item
presetName
unit		 חלוקת פריטים.
‫device.command.Dock מעגנים את המכשיר.
device.command.EnableDisableGuestNetwork enable מפעילים או משביתים את הרשת לאורחים.
device.command.EnableDisableNetworkProfile הפעלת פרופיל
 הפעלה או השבתה של פרופיל רשת. חובה להשתמש באימות משתמש נוסף (SUV) באמצעות קוד סודי. אפשר לומר שהאבטחה בבית של משתמש נפגעת אם מכשירי אבטחה אחרים מושבתים באמצעות הפקודות האלה.
‫device.command.Fill fill
fillLevel		 מילוי או ריקון של המכשיר.
‫device.command.FindMyDevice להשתיק איתור מכשיר היעד על ידי יצירת התראה מקומית.
device.command.HumidityRelative relativeHumidityPercent
relativeHumidityWeight		 משנים את רמת הלחות ביחס לערך הנוכחי.
device.command.LightEffectColorLoop משך מעבר בין סדרה של צבעים במכשיר.
device.command.LightEffectPulse משך עוצמת האור עולה מבהירות ברמה בינונית לבהירות מקסימלית, ואז יורדת לבהירות ברמה בינונית. משך מחזור הפעילות הכולל הוא פעימה אחת לשנייה. במהלך כל מחזור, הבהירות המקסימלית צריכה להימשך 200 אלפיות השנייה, והבהירות ברמה הבינונית, לא כולל תקופת המעבר, צריכה להימשך לפחות 500 אלפיות השנייה.
device.command.LightEffectSleep משך במהלך פרק זמן מסוים, מורידים בהדרגה את הבהירות של המכשיר ומשנים את טמפרטורת הצבע (אופציונלי).
device.command.LightEffectWake משך במהלך פרק זמן מסוים, מגבירים בהדרגה את הבהירות של המכשיר, ואם המכשיר תומך באפקט, משנים את טמפרטורת הצבע.
‫device.command.LockUnlock מנעול לנעול או לבטל את הנעילה של המכשיר.
device.command.MediaNext דילוג לפריט המדיה הבא.
device.command.MediaPause השהיית הפעלת המדיה.
‫device.command.MediaPrevious דילוג לפריט המדיה הקודם.
device.command.MediaResume המשך הפעלת המדיה.
device.command.MediaShuffle הפעלת הפלייליסט הנוכחי בסדר אקראי.
device.command.MediaStop הפסקת ההפעלה של המדיה.
‫device.command.Mute השתקה השתקה או ביטול ההשתקה של המכשיר.
device.command.NextInput מעבר לקלט הבא.
device.command.OnOff מופעל מפעילים או מכבים את המכשיר.
‫device.command.OpenClose openDirection
openPercent		 הגדרת מצב הפתיחה והסגירה של המכשיר
‫device.command.PauseUnpause השהיה השהיה או ביטול ההשהיה של פעולת המכשיר.
device.command.PreviousInput מעבר לקלט הקודם.
‫device.command.Reboot מפעיל מחדש את המכשיר.
device.command.RelativeChannel channelCount שינוי הערוץ הנוכחי בסכום יחסי.
device.command.ReturnChannel חזרה לערוץ הקודם שבו המשתמש צפה.
device.command.ReverseFan היפוך הכיוון של המאוורר.
‫device.command.RotateAbsolute ‫rotationDegrees
rotationPercent		 הגדרת הסיבוב האבסולוטי של המכשיר.
‫device.command.SelectChannel channelCode
channelName
channelNumber		 הגדרת הערוץ הנוכחי לערך ספציפי.
device.command.SetFanSpeed fanSpeed מגדירים את מהירות המאוורר.
device.command.SetFanSpeedRelative fanSpeedRelativePercent
fanSpeedRelativeWeight		 מגדירים את המהירות היחסית של המאוורר.
device.command.SetHumidity לחות הגדרת רמת הלחות לערך מוחלט.
device.command.SetInput newInput מגדירים את קלט המדיה.
device.command.SetVolume volumeLevel הגדרת עוצמת הקול של מכשיר מסוים.
device.command.StartStop start הפעלה או הפסקה של המכשיר.
device.command.StopLightEffect הפסקת אפקט התאורה הנוכחי.
device.command.ThermostatSetMode thermostatMode הגדרת מצב הפעולה הרצוי של מכשיר תרמוסטט.
‫device.command.ThermostatTemperatureSetpoint thermostatTemperatureSetpoint הגדרת טמפרטורת היעד של מכשיר תרמוסטט.
‫device.command.ThermostatTemperatureSetRange thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow		 הגדרת טווח טמפרטורה יעד למכשיר תרמוסטט.
‫device.command.TimerAdjust משך משנים את משך הזמן של הטיימר.
‫device.command.TimerCancel לבטל את הטיימר.
‫device.command.TimerPause תשהה את הטיימר.
‫device.command.TimerResume תפעיל שוב את הטיימר.
device.command.TimerStart משך להתחיל טיימר חדש.
device.event.AnimalOtherDetection המצלמה זיהתה כלב או חתול. המצלמה לא יכולה לזהות בעלי חיים אחרים.
‫device.event.DoorbellPress מישהו לחץ על פעמון הדלת.
device.event.FaceFamiliarDetection המצלמה זיהתה פנים מוכרות.
device.event.FaceUnfamiliarDetection המצלמה זיהתה פנים לא מוכרות.
device.event.MotionDetection המכשיר זיהה תנועה.
device.event.MovingVehicleDetection המצלמה זיהתה כלי רכב בתנועה.
device.event.PackageDelivered המצלמה זיהתה חבילה שנמסרה.
device.event.PersonDetection המצלמה זיהתה אדם.
device.event.PersonTalking המכשיר זיהה קול של אדם מדבר.
‫device.event.Sound המכשיר זיהה קול.
device.state.AppSelector currentApplication למכשירים שאפשר לעבור בין אפליקציות בהם.
device.state.ArmDisarm currentArmLevel
isArmed		 במכשירים כמו מערכות אבטחה שתומכים בהפעלה ובהשבתה, הערך הזה מציין אם המכשיר מופעל או מושבת.
‫device.state.Brightness בהירות הגדרת הבהירות של המכשיר.
‫device.state.Channel למכשירים שתומכים בערוצים במכשיר מדיה.
‫device.state.ColorSetting ‫color.colorTemperature
color.spectrumHsv.hue
color.spectrumHsv.saturation
color.spectrumHsv.value
color.spectrumRgb		 המצב של הגדרת צבע.
device.state.Cook currentCookingMode
currentFoodPreset		 למכשירים שיכולים לבשל אוכל לפי הגדרות קבועות מראש שונות של אוכל ומצבי בישול נתמכים.
‫device.state.Dock isDocked למכשירים ניידים עצמאיים שאפשר לתת להם פקודה לחזור לטעינה.
device.state.EnergyStorage descriptiveCapacityRemaining
isCharging
isPluggedIn		 המצב של מכשיר לאגירת אנרגיה, כמו סוללה, כולל כמות האנרגיה שהוא אוגר, אם הוא נטען ואם הוא מחובר לחשמל.
‫device.state.FanSpeed currentFanSpeedPercent
currentFanSpeedSetting		 למכשירים שתומכים בהגדרת מהירות המאוורר.
‫device.state.Fill currentFillLevel
currentFillPercent
isFilled		 למכשירים שאפשר למלא, כמו אמבטיה.
device.state.HumiditySetting humidityAmbientPercent
humiditySetpointPercent		 למכשירים שתומכים בהגדרות לחות, כמו מכשירי אדים ומכשירי הסרת לחות.
device.state.InputSelector currentInput ההגדרה מאפשרת לשלוח שאילתות למכשירים שיכולים להחליף את מקורות הקלט. לכניסות של מדיה יכולים להיות שמות דינמיים לכל מכשיר שמייצגים פידים של אודיו או וידאו. הפידים האלה יכולים להיות מחוברים באמצעות חוטים או ברשת, אבל צריך לתת להם שם והם צריכים להיות יציבים למדי. התכונה הזו לא תומכת בפידים זמניים שרירותיים, כמו ספרייה ברשת שאפשר לחפש בה. יש תמיכה במקורות Bluetooth מותאמים עם שם. למקורות יכולים להיות כמה שמות, ולכן נתמכים שמות שנוצרו על ידי משתמשים ושמות שזוהו, וגם שמות ברירת מחדל. לדוגמה, 'hdmi_1' יכול להיות גם 'DVD player', או 'usb_1' יכול להיות גם 'Hard drive'. אפשר להזמין קלט מדיה כדי לתמוך בפקודות 'הבא' ו 'הקודם'. הערה: InputSelector לא תומכת בתחביר של שאילתות.
device.state.LightEffects activeLightEffect למכשירים שיכולים לתמוך בפקודות תאורה מורכבות לשינוי מצב, כמו מעבר בין צבעים שונים.
device.state.LockUnlock isJammed
isLocked		 למכשירים שתומכים בנעילה ובביטול נעילה, ו/או בדיווח על מצב נעול.
‫device.state.MediaState playbackState במכשירים שמפעילים מדיה, מצב המדיה, למשל אם היא פועלת או לא.
device.state.MotionDetection motionDetectionEventInProgress למכשירים שיכולים לזהות תנועה.
device.state.OccupancySensing תפוסה למכשירים שיכולים לזהות נוכחות של אנשים, בין אם באמצעות חיישן PIR, אולטרסאונד או חיישן מגע פיזי.
‫device.state.Online online למכשירים שתומכים במצב אונליין ואופליין, או שמדווחים על מצב אונליין ואופליין.
‫device.state.OnOff מופעל הפונקציונליות הבסיסית של הפעלה וכיבוי לכל מכשיר עם הפעלה וכיבוי בינאריים, כולל שקעים ומתגים, וגם מכשירים רבים בעתיד.
‫device.state.OpenClose openPercent למכשירים שתומכים בפתיחה ובסגירה, ובמקרים מסוימים בפתיחה ובסגירה חלקיות או בכיוונים שונים.
device.state.Record isCurrentlyRecording למכשירים שתומכים בהקלטה למדיה.
‫device.state.Rotation ‫rotationDegrees
rotationPercent		 למכשירים שתומכים בסיבוב, כמו תריסים עם שלבים מסתובבים.
‫device.state.RunCycle currentCycleRemainingTime
currentTotalRemainingTime		 למכשירים שיש להם משך פעולה מתמשך שאפשר לשלוח לגביו שאילתה. מכשירים כאלה ידווחו על המספר הכולל של המחזורים בתחילת הפעולה, ועל כל מחזור שהמכשיר נמצא בו בזמן שהוא פועל.
‫device.state.SensorState currentSensorStateData.key
currentSensorStateData.value.currentSensorState
currentSensorStateData.value.rawValue		 מדידה שמתבצעת על ידי חיישן. לדוגמה, כמות העשן שנמדדת על ידי גלאי עשן, או כמות הפחמן החד-חמצני שנמדדת על ידי גלאי פחמן חד-חמצני וכו'.
device.state.StartStop isPaused
isRunning		 למכשירים שתומכים בהתחלה ובעצירה של פעולות. הפעלה והפסקה של מכשיר דומות להפעלה ולכיבוי שלו. הן מציינות שהמכשירים פועלים בצורה שונה כשהם מופעלים וכשהם מתחילים לפעול. לדוגמה, אפשר להפעיל מכונות כביסה מסוימות ולשנות את ההגדרות שלהן לפני שמתחילים להשתמש בהן.
device.state.TemperatureControl temperatureAmbient
temperatureSetpoint		 שליטה בטמפרטורה של מכשיר שאינו תרמוסטט (למשל, תנור), בתוך המכשיר או בסביבתו.
‫device.state.TemperatureSetting activeThermostatMode
thermostatHumidityAmbient
thermostatMode
thermostatTemperatureAmbient
thermostatTemperatureSetpoint
thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow		 למכשירים שתומכים בנקודות ובמצבים של טמפרטורה.
‫device.state.Timer timerPaused למכשירים שתומכים ביכולת של טיימר. לדוגמה, בקר חכם של ממטרה או מתג חכם של תאורה עשויים לכלול טיימר מובנה. אפשר להשתמש בטיימר הזה כדי לשאול את המכשיר כמה זמן נשאר עד שהטיימר יסתיים.
‫device.state.Volume currentVolume
isMuted		 למכשירים שאפשר לשנות את עוצמת הקול שלהם (למשל, להגדיר את עוצמת הקול לרמה מסוימת, להשתיק או לבטל השתקה).
‫home.command.Notification body
members
title		 שליחת התראה לבני הבית שצוינו באמצעות כתובת האימייל שלהם.
‫home.state.HomePresence homePresenceMode
‫not תנאי שמייצג NOT לוגי של תנאי אחר.
או תנאי מורכב שמייצג את האופרטור הלוגי OR של כל תנאי הצאצא.
time.between מייצג טווח זמן.
זמן.עיכוב הוספת השהיה בהרצת האוטומציה.
time.schedule מייצג אירוע בלוח זמנים.