آغازگرها، شرایط، و کنش‌های پشتیبانی‌شده

خودکارسازی‌ها از آغازگرها و کنش‌های زیر پشتیبانی می‌کنند. همه استان‌ها نیز به‌عنوان شرط پشتیبانی می‌شوند.

وضعیت / رویداد (آغازگر)
شرط
فرمان (کنش)
فیلدهای پشتیبانی‌شده شرح
و شرط مرکبی که نشان‌دهنده «و» منطقی همه شرایط فرزند است.
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 روشنایی روشنایی مطلق دستگاه را تنظیم کنید. وقتی روشنایی روی هر مقداری بیشتر از ۰ تنظیم شود، اگر دستگاه خاموش باشد، روشن می‌شود و [`OnOffState.state`](./on_off_state) تغییر می‌کند تا نشان دهد دستگاه روشن است. به‌همین ترتیب، وقتی روشنایی روی ۰ تنظیم شود، دستگاه خاموش می‌شود و [`OnOffState.state`](./on_off_state) مطابق با آن تغییر می‌کند.
device.command.BrightnessRelative brightnessRelativePercent
brightnessRelativeWeight
روشنایی نسبی دستگاه را تنظیم کنید. وقتی روشنایی روی هر مقداری بیشتر از ۰ تنظیم شود، اگر دستگاه خاموش باشد، روشن می‌شود و [`OnOffState.state`](./on_off_state) تغییر می‌کند تا نشان دهد دستگاه روشن است. به‌همین ترتیب، وقتی روشنایی روی ۰ تنظیم شود، دستگاه خاموش می‌شود و [`OnOffState.state`](./on_off_state) مطابق با آن تغییر می‌کند.
دستگاه.فرمان.شارژ شارژ شارژ را شروع یا متوقف کنید.
device.command.ColorAbsolute color.name
color.spectrumHSV.hue
color.spectrumHSV.saturation
color.spectrumHSV.value
color.spectrumRGB
color.temperature
رنگ را روی رنگ‌مایه مشخص‌شده تنظیم می‌کند. وقتی رنگ روی دستگاهی که خاموش است تنظیم می‌شود، دستگاه روشن می‌شود و [`OnOffState.state`](./on_off_state) تغییر می‌کند تا این موضوع را نشان دهد. به‌همین ترتیب، وقتی روشنایی روی ۰ تنظیم شود، دستگاه خاموش می‌شود و [`OnOffState.state`](./on_off_state) مطابق با آن تغییر می‌کند.
دستگاه.فرمان.پختن cookingMode
foodPreset
quantity
start
unit
پختن را شروع یا متوقف کنید.
device.command.Dispense amount
item
presetName
unit
موارد را توزیع کنید.
device.command.Dock دستگاه را روی پایه قرار دهید.
device.command.EnableDisableGuestNetwork فعال کردن شبکه مهمان را فعال یا غیرفعال کنید.
device.command.EnableDisableNetworkProfile فعال کردن
نمایه
نمایه شبکه را فعال یا غیرفعال کنید. باید از درستی‌سنجی ثانویه کاربر با پین استفاده شود. اگر دستگاه‌های امنیتی دیگر ازطریق این فرمان‌ها غیرفعال شوند، می‌توان امنیت خانه کاربر را تحت‌تأثیر قرار داد.
device.command.Fill fill
fillLevel
دستگاه را پر یا خالی کنید.
device.command.FindMyDevice بی‌صدا کردن با ایجاد هشدار محلی، دستگاه هدف را مکان‌یابی کنید.
device.command.HumidityRelative relativeHumidityPercent
relativeHumidityWeight
سطح رطوبت را نسبت به مقدار فعلی تنظیم کنید.
device.command.LightEffectColorLoop مدت دستگاه را در مجموعه‌ای از رنگ‌ها بچرخانید.
دستگاه.فرمان.LightEffectPulse مدت شدت نور از روشنایی سطح متوسط به حداکثر روشنایی افزایش می‌یابد و سپس با مدت چرخه کلی یک پالس در ثانیه به روشنایی سطح متوسط کاهش می‌یابد. درطول هر چرخه، حداکثر روشنایی باید ۲۰۰ میلی‌ثانیه طول بکشد و روشنایی سطح متوسط، به‌استثنای دوره گذار، باید حداقل ۵۰۰ میلی‌ثانیه طول بکشد.
دستگاه.فرمان.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 شروع دستگاه را راه‌اندازی یا متوقف کنید.
device.command.StopLightEffect جلوه نوری فعلی را متوقف می‌کند.
device.command.ThermostatSetMode thermostatMode حالت عملکرد هدف را برای دستگاه دماپا تنظیم کنید.
device.command.ThermostatTemperatureSetpoint thermostatTemperatureSetpoint دمای هدف را برای دستگاه دماپا تنظیم کنید.
device.command.ThermostatTemperatureSetRange thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
محدوده دمای هدف را برای دستگاه دماپا تنظیم کنید.
device.command.TimerAdjust مدت مدت زمان‌سنج را تنظیم کنید.
دستگاه.فرمان.لغو زمان‌سنج زمان‌سنج را لغو کن.
device.command.TimerPause زمان‌سنج را موقتاً متوقف کن.
دستگاه.فرمان.ازسرگیری زمان‌سنج زمان‌سنج را ازسر بگیر.
دستگاه.فرمان.شروع زمان‌سنج مدت زمان‌سنج جدیدی را شروع کنید.
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.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 دستگاه‌های پرسمان را که می‌توانند ورودی‌ها را عوض کنند فعال می‌کند. ورودی‌های رسانه می‌توانند نام‌های پویایی برای هر دستگاه داشته باشند که نشان‌دهنده فیدهای صوتی یا ویدیویی است. این فیدها می‌توانند سخت‌سیمی یا شبکه‌ای باشند، اما باید نام‌گذاری شده و به‌طور منطقی پایدار باشند. این مورد از فیدهای زودگذر دلخواه، مثل کتابخانه شبکه‌ای قابل‌جستجو، پشتیبانی نمی‌کند. منابع بلوتوث جفت‌شده و نام‌گذاری‌شده پشتیبانی می‌شوند. منابع می‌توانند چندین نام داشته باشند، بنابراین نام‌های ایجادشده و کشف‌شده توسط کاربر و همچنین نام‌های پیش‌فرض پشتیبانی می‌شوند؛ برای مثال، «hdmi_1» ممکن است «پخش‌کننده DVD» نیز باشد، یا «usb_1» ممکن است «دیسک سخت» نیز باشد. ورودی‌های رسانه را می‌توان برای پشتیبانی از فرمان‌های «بعدی» و «قبلی» مرتب کرد. توجه: 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 آنلاین برای دستگاه‌هایی که از وضعیت آنلاین و آفلاین پشتیبانی می‌کنند و/یا وضعیت آنلاین و آفلاین را گزارش می‌کنند.
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 منطقی شرطی دیگر.
یا شرط مرکبی که نشان‌دهنده «یا» منطقی همه شرط‌های فرزند است.
time.between نشان‌دهنده محدوده زمانی است.
time.delay مکثی در اجرای خودکارسازی اضافه می‌کند.
time.schedule رویداد زمان‌بندی را نشان می‌دهد.