ברוכים הבאים למרכז המפתחים של Google Home. זהו היעד החדש ללימוד פיתוח פעולות לבית חכם. הערה:תצטרכו להמשיך ליצור פעולות במסוף הפעולות.

תכונות של מכשיר לבית חכם

הפונקציונליות של סוגי המכשירים מבוססת על התכונות שמוסיפים לכל אחד מהם. לכל סוג מכשיר יש מספר תכונות מומלצות, אבל אפשר להוסיף את התכונות הרצויות. אימות משתמש משני נתמך בכל תכונות המכשיר.

אפשר לעיין ברשימה של שפות נתמכות של כל התכונות.

Name התכונה במכשיר תיאור סוגי מכשירים מומלצים
AppSelector action.devices.traits.AppSelector התכונה הזו שייכת למכשירים שתומכים באפליקציות מדיה, לרוב מצדדים שלישיים. מכשירי מדיה שתומכים בהפעלה, בהתקנה ובחיפוש של אפליקציות שפועלות במכשיר.
ארמסטראם action.devices.traits.ArmDisarm תכונה זו תומכת בנשק ובכיבוי, כמו באמצעות מערכות אבטחה. מערכות אבטחה או כל מכשיר שתומך בנשק ובכיבוי.
בהירות action.devices.traits.Brightness הגדרת הבהירות המוחלטת נמצאת בטווח מנורמל מ-0 עד 100 (יכול להיות שהנורות הנפרדות לא יתמכו בכל נקודה בטווח, בהתאם לתצורת ה-LED שלהן). בהיר
CameraStream action.devices.traits.CameraStream התכונה הזו שייכת למכשירים שמסוגלים לשדר עדכוני וידאו בסטרימינג למסכים של צדדים שלישיים, למסכים שמחוברים ל-Chromecast או לסמארטפונים. ובגדול, אלו הן מצלמות אבטחה או מצלמות לתינוקות. אבל התכונה הזו חלה גם על מכשירים מורכבים יותר שיש בהם מצלמה (לדוגמה, מכשירים לשיחות ועידה בווידאו או שואב אבק עם מצלמה). מצלמה
ערוץ action.devices.traits.Channel התכונה הזו שייכת למכשירים שתומכים בערוצי טלוויזיה במכשיר מדיה. טלוויזיה
הגדרת צבעים action.devices.traits.ColorSetting התכונה הזו חלה על מכשירים, כמו נורות חכמות, שיכולים לשנות את הצבע או את טמפרטורת הצבע. בהיר
ColorSpectrum action.devices.traits.ColorSpectrum ההגדרה הזו רלוונטית לנורות צבעים "מלאות" שמשתמשות בטווחי צבעי RGB. לתאורה יכולים להיות כל שילוב של ColorSpectrum ו-ColorTemperature. בתאורה בולטת וברצועות LED יכול להיות רק ספקטרום, אבל בספרים מסוימים יש טמפרטורה מסוימת. גם נורות בסיסיות, או נורות מטופחות על שקעים חכמים, לא דולקות. בהיר
טמפרטורת צבעים action.devices.traits.ColorTemperature ההגדרה הזו רלוונטית לנורות 'חמימות' שמקבלות נקודת צבע בקלווין. בדרך כלל מדובר בפעולה נפרדת מ-ColorSpectrum, וייתכן שיש נקודות לבנות זמינות באמצעות הטמפרטורה, שלא ניתן להגיע אליה באמצעות Spectrum. בהתאם למאפיינים הזמינים, Google עשויה לבחור את המצב המתאים לשימוש על סמך בקשה וסוג תאורה (למשל, הגדרה של תאורה בסלון לבנה עשויה לשלוח פקודות טמפרטורה לחלק מהנורות ופקודות Spectrum ברצועות LED). בהיר
בישול action.devices.traits.Cook תכונה זו שייכת למכשירים שמבשלים מזון לפי הגדרות קבועות מראש של מזון ומצבי בישול נתמכים. מכשירים שתומכים בבישול בסוגים שונים של מזון.
תיאור action.devices.traits.Dispense התכונה הזו שייכת למכשירים שתומכים בכמות של פריט פיזי אחד או יותר. לדוגמה, במכשיר לטיפוח של כלב אפשר לקטוע מספר חטיפים, לברז אפשר למזוג כוסות מים, ומזין אוכל לחיות מחמד עשוי לחלץ גם מים וגם מזון לחיות מחמד. מכשירים שתומכים בהעברת כמות מסוימת של פריט פיזי אחד או יותר.
אביזר עגינה action.devices.traits.Dock תכונה זו מיועדת למכשירים ניידים עצמיים, שאותם אפשר להורות להחזיר תמורת טעינה. שואב אבק
EnergyStorage action.devices.traits.EnergyStorage התכונה הזו שייכת למכשירים שיכולים לאחסן אנרגיה בתוך סוללה שעלולה להיטען, או למכשירים שמסוגלים לטעון מכשיר אחר. הפיצ'ר תומך בהפעלה ובעצירה של הטעינה ובודק את רמת הטעינה הנוכחית, את הקיבולת שנותרה ואת הקיבולת עד לערכים המלאים. מכשירים שיכולים לטעון את הסוללה שלהם.
מהירות אוהדים action.devices.traits.FanSpeed התכונה הזו שייכת למכשירים שתומכים בהגדרת המהירות של המאוורר (כלומר, נשיפה של האוויר ברמות שונות, שעשויות להיות חלק מיחידת מיזוג אוויר או חימום, או מרכב), עם הגדרות כמו נמוכה, בינונית וגבוהה.
מילוי action.devices.traits.Fill התכונה הזו חלה על מכשירים שתומכים במילוי, כמו אמבטיה. כל מכשיר התומך במילוי, כמו אמבטיה.
הגדרת לחות action.devices.traits.HumiditySetting תכונה זו שייכת למכשירים שתומכים בהגדרות לחות, כגון מכשירי אדים ומייבש אוויר. כל מכשיר שתומך בהגדרות לחות, כמו מכשיר אדים או מכשיר אדים.
InputSelector action.devices.traits.InputSelector מאפיין זה מיועד למכשירים שיכולים לשנות קלט מדיה. לקלטים האלה יכולים להיות שמות דינמיים בכל מכשיר, והם יכולים לייצג פידים של אודיו או וידאו, עם חיבור קווי או עם חיבור לרשת. כל מכשיר מדיה שתומך בהעברת קלט.
LightImpacts action.devices.traits.LightEffects התכונה הזו שייכת למכשירים שיכולים לתמוך בפקודות תאורה מורכבות כדי לשנות את המצב, כמו מעבר בין צבעים שונים. בהיר
איתור action.devices.traits.Locator תכונה זו משמשת עבור מכשירים שניתן "למצוא" אותם. השירותים כוללים טלפונים, רובוטים (כולל שואבי אבק ומכסחות דשא, רחפנים ומוצרים ספציפיים לתגים שמתחברים למכשירים אחרים). כל מכשיר שצריך להיות נמצא בו, כמו שואב אבק רובוטי
ביטול הנעילה action.devices.traits.LockUnlock התכונה הזו שייכת למכשירים שתומכים בנעילה ובביטול נעילה ו/או בדיווח על מצב נעול. כל מכשיר שתומך בנעילה ובביטול נעילה ו/או בדיווח על מצב נעילה.
MediaState action.devices.traits.MediaState תכונה זו משמשת עבור מכשירים המסוגלים לדווח על מצבי מדיה. כל מכשיר מדיה שמסוגל לדווח על מצבי מדיה
מצבים action.devices.traits.Modes תכונה זו שייכת לכל מכשיר עם מספר שרירותי של מצבים "עקומים". המצבים וההגדרות של כל מצב הם שרירותיים וייחודיים לכל מכשיר או סוג מכשיר. בכל מצב ניתן לבחור מספר הגדרות אפשריות, אבל ניתן לבחור רק אחת בכל פעם. המייבש לא יכול להיות במצב "חם", "רגיל" או "כבד". אפשר פשוט להפעיל או להשבית את ההגדרה הזו בתכונה משקפיים. ללא הגבלת תאריך
NetworkControl action.devices.traits.NetworkControl התכונה הזו שייכת למכשירים שתומכים בדיווח על נתוני רשת ובביצוע פעולות ספציפיות לרשת. מכשירים שניתן לדווח עליהם נתוני רשת ולבצע פעולות ספציפיות לרשת.
אובייקט זיהוי action.devices.traits.ObjectDetection התכונה הזו שייכת למכשירים שיכולים לזהות אובייקטים או אנשים ולשלוח הודעה למשתמש. לדוגמה, ניתן להשתמש בפעמוני הדלת כדי לציין שאדם (בשם או ללא שם) צלצל בפעמון הדלת, וכן במצלמות ובחיישנים שיכולים לזהות תנועה של אובייקטים או אנשים שניגשים אליהם. מכשירים שיכולים לזהות אובייקטים או אנשים ולשלוח התראה למשתמש.
כבוי action.devices.traits.OnOff הפונקציונליות הבסיסית להפעלה ולכיבוי של כל מכשיר שבינארי ומופעל בו, כולל שקעים ומתגים, וגם מכשירים עתידיים רבים.
OpenClose action.devices.traits.OpenClose התכונה הזו שייכת למכשירים שתומכים בפתיחה וסגירה, ובמקרים מסוימים פותחים וסוגרים באופן חלקי או אפילו בכיוון אחד. לדוגמה, יש תריסים שנפתחים שמאלה או ימינה. במקרים מסוימים, הפתיחה של מכשירים מסוימים עשויה להיות פעולה רגישה מבחינת אבטחה, ויכול להיות שיהיה צורך באימות דו-שלבי. מומלץ לקרוא את המאמר אימות דו-שלבי. כל מכשיר שתומך בפתיחה וסגירה.
הפעלה מחדש action.devices.traits.Reboot התכונה הזו שייכת למכשירים שתומכים בהפעלה מחדש, כמו נתבים. המכשיר צריך לתמוך בהפעלה מחדש כפעולה אחת. כל מכשיר שתומך בהפעלה מחדש.
סיבוב action.devices.traits.Rotation התכונה הזו שייכת למכשירים שתומכים בסיבוב, כמו תריסים שניתן לסובב אותם. מכשירים שתומכים בסיבוב, כמו תריסים עם יריעות סיבוב.
RunCycle action.devices.traits.RunCycle תכונה זו מייצגת כל מכשיר שמשך הפעילות שלו קבוע, וניתן לבצע שאילתה לגביו. המכשירים האלה כוללים, בין היתר, מכשירים שפועלים בצורה מחזורית, כמו מכונות כביסה, מייבשים ומדיחי כלים. הכול – בעיקר מכשירי חשמל ומכשירים אחרים עם מצבי הפעלה
SensorState action.devices.traits.SensorState התכונה הזו כוללת מדידה כמותית (למשל, מדד איכות האוויר או רמת העשן) וגם מצב איכות (למשל, האם איכות האוויר תקינה או אם רמת העשן נמוכה או גבוהה). חיישנים שמספקים מדידה כמותית (כגון רמת העשן) ומצב איכותי (אם איכות האוויר תקינה)
מסך action.devices.traits.Scene במקרה של סצנות, הסוג ממופה עם יחס של 1:1 אל התמונה, כיוון שהסצנות לא משולבות עם תכונות אחרות כדי ליצור מכשירים מורכבים. תרחיש בלבד
עדכון תוכנה action.devices.traits.SoftwareUpdate התכונה הזו שייכת למכשירים שתומכים בעדכוני תוכנה כמו נתב. כל מכשיר שתומך בעדכוני תוכנה.
StartStop action.devices.traits.StartStop הפעלה והפסקה של מכשיר ממלאת פונקציה דומה להפעלה ולכיבוי שלו. מכשירים שיקבלו בירושה את פונקציית התכונה הזו באופן שונה כשמפעילים אותה ומתי שהתחילו. בשונה ממכשירים עם מצב 'מופעל' ו'כבוי', מכשירים מסוימים שיכולים להתחיל ולהפסיק אותה יכולים גם הם להשהות בעת ביצוע פעולה. כל המכשירים – בעיקר שואבי אבק, שואבי אבק ודברים אחרים שיש להם התנהגות ספציפית של פעילות מעל ומחוץ לחשמל
דוח סטטוס action.devices.traits.StatusReport תכונה זו מדווחת על הסטטוס הנוכחי של מכשיר ספציפי או על מצב של מכשיר מחובר. תכונה כללית שמיועדת לדיווח על הסטטוס הנוכחי של מכשיר מסוים או על הסטטוס שלו, או על קבוצת מכשירים מחוברים, כמו מערכת אבטחה)
בקרת טמפרטורה action.devices.traits.TemperatureControl מעקב אחר מכשירים (שאינם תרמוסטטים) שתומכים בטמפרטורת בקרה, בתוך המכשיר או בקרבתו. המכשירים האלה כוללים מכשירים כמו תנורים ומקררים.
הגדרת טמפרטורה action.devices.traits.TemperatureSetting המאפיין הזה עוסק גם בטמפרטורה וגם במצבים.
טיימר action.devices.traits.Timer התכונה 'טיימר' מייצגת טיימר במכשיר, בעיקר מכשירי חשמל למטבח כמו תנורים ומיקרוגלים, אבל לא רק כאלה. כל מכשיר עם טיימר, כמו מכשירי חשמל למטבח כמו מיקרוגלים או תנורים.
תיקים action.devices.traits.Toggles התכונה הזו שייכת לכל מכשיר עם הגדרות שיכולות להתקיים רק באחד משני מצבים. ההגדרות האלה יכולות לייצג לחצן פיזי עם מצב מופעל/מושבת או לא פעיל, תיבת סימון ב-HTML או כל רכיב אחר שמופעל או הושבת באופן ספציפי. ללא הגבלת תאריך
TransportControl action.devices.traits.TransportControl התכונה הזו תומכת במכשירי מדיה שמסוגלים לשלוט בהפעלת מדיה (לדוגמה, המשך השמעת המוזיקה שהושהתה). מכשירים תומכים בתקשורת אודיו דו-כיוונית עם מכשירים של צד שלישי.
עוצמת קול action.devices.traits.Volume התכונה הזו שייכת למכשירים שיכולים לשנות את עוצמת הקול (לדוגמה, הגדרת עוצמת הקול לרמה מסוימת, להשתקה או לביטול השתקה). מכשירי מדיה שיש להם אפשרות לשנות את עוצמת הקול.

שפות נתמכות

השפות הבאות נתמכות בכל התכונות שלמעלה:

  • דנית (da)
  • הולנדית (nl)
  • אנגלית (en)
  • צרפתית (fr)
  • גרמנית (de)
  • הינדית (hi)
  • אינדונזית (id)
  • איטלקית (it)
  • יפנית (ja)
  • קוריאנית (ko)
  • נורווגית (no)
  • פורטוגזית (pt-BR)
  • ספרדית (es)
  • שוודית (sv)
  • תאית (th)
  • סינית (zh-TW)