مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مخطط سمات SmartSpectrum Home الذكي

action.devices.traits.ColorSpectrum - تنتمي هذه السمة إلى أي جهاز يمكنه تعيين نطاق ألوان. وينطبق هذا على مصابيح الألوان "الكاملة" التي تستخدم نطاقات ألوان نموذج أحمر أخضر أزرق. قد يكون للإضاءة أي مزيج من ColorSpectrum وColorTemperature. يمكن أن تحتوي أضواء الأشرطة وأشرطة LED على طيف، بينما تحتوي بعض مصابيح القراءة على درجة حرارة. وكذلك المصابيح الأساسية أو المصابيح الغبية في المقابس الذكية.

الجهاز ATTRIBUTES

السمة التعريف
colorModel اختياريّ. يمكن ضبطها على السلسلة hsv للإشارة إلى الإعدادات المفضّلة للجهاز في نموذج ألوان HSV (درجة اللون، التشبع، القيمة). القيمة التلقائية هي rgb.

نموذج لطلب واستجابة SYNC

طلب
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "inputs": [{
      "intent": "action.devices.SYNC"
    }]
}
Node.js
'use strict';

const {smarthome} = require('actions-on-google');
const functions = require('firebase-functions');

const app = smarthome();

app.onSync((body, headers) => {
  return {
    requestId: body.requestId,
    payload: {
      agentUserId: '1836.15267389',
      devices: [{
        id: '123',
        type: 'action.devices.types.LIGHT',
        traits: [
          'action.devices.traits.ColorSpectrum'
        ],
        name: {
          defaultNames: ['AAA bulb A19 color hyperglow'],
          name: 'lamp1',
          nicknames: ['reading lamp']
        },
        willReportState: true,
        attributes: {
          colorModel: 'rgb'
        },
        deviceInfo: {
          manufacturer: 'AAA',
          model: 'hg11',
          hwVersion: '1.2',
          swVersion: '5.4'
        },
        customData: {
          fooValue: 12,
          barValue: false,
          bazValue: 'dancing alpaca'
        }
      }]
    }
  };
});

// ...

exports.smarthome = functions.https.onRequest(app);
JSON
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.LIGHT",
        "traits": [
          "action.devices.traits.ColorSpectrum"
        ],
        "name": {
          "defaultNames": [
            "AAA bulb A19 color hyperglow"
          ],
          "name": "lamp1",
          "nicknames": [
            "reading lamp"
          ]
        },
        "willReportState": true,
        "attributes": {
          "colorModel": "rgb"
        },
        "deviceInfo": {
          "manufacturer": "AAA",
          "model": "hg11",
          "hwVersion": "1.2",
          "swVersion": "5.4"
        },
        "customData": {
          "fooValue": 12,
          "barValue": false,
          "bazValue": "dancing alpaca"
        }
      }
    ]
  }
}
أداة التحقّق من صحة البيانات

حالة الجهاز STATES

الولاية التعريف
color كائن. إعداد اللون الحالي. بما أنّ هناك ضوءًا معيّنًا في وضع الطيف أو درجة الحرارة، يتضمّن هذا الكائن إعدادات الألوان الحالية في الوضع ذي الصلة.
  • سلسلة name. إذا كانت نقطة اللون (الطيف أو درجة الحرارة) تتطابق مع اسم تم إعداده مسبقًا في قائمة ألوان الشريك، اعرض الاسم.
  • spectrumRGB عدد صحيح. قيمة الطيف بنموذج RGB (قيمة سداسية عشرية كعدد صحيح).

مفاتيح COMMAND

Command المعلّمات/التعريف
action.devices.commands.ColorAbsolute color كائن. مطلوبة. سيتضمن نموذج أحمر أخضر أزرق أو درجة الحرارة، بالإضافة إلى اسم اختياريًا.
  • سلسلة name. اسم اللون (باللغة الإنجليزية) على النحو المنصوص عليه في أمر المستخدم. غير متوفرة دائمًا (للأوامر النسبية).
  • spectrumRGB عدد صحيح. قيمة الطيف بنموذج RGB (قيمة سداسية عشرية كعدد صحيح).

نموذج لطلب واستجابة من EXECUTE

ضبط المصباح على اللون الأحمر
طلب
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123",
          "customData": {
            "fooValue": 74,
            "barValue": true,
            "bazValue": "sheepdip"
          }
        }],
        "execution": [{
          "command": "action.devices.commands.ColorAbsolute",
          "params": {
            "color": {
            "name": "red",
            "spectrumRGB": 16711680
            }
          }
        }]
      }]
    }
  }]
}
Node.js
'use strict';

const {smarthome} = require('actions-on-google');
const functions = require('firebase-functions');

const app = smarthome();

app.onExecute((body, headers) => {
  return {
    requestId: body.requestId,
    payload: {
      commands: [{
        ids: ['123'],
        status: 'SUCCESS',
        states: {
          color: {
            name: 'red',
            spectrumRGB: 12655639
          }
        }
      }]
    }
  };
});

// ...

exports.smarthome = functions.https.onRequest(app);
JSON
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "color": {
            "name": "red",
            "spectrumRGB": 12655639
          }
        }
      }
    ]
  }
}
تشمل أمثلة الاستدعاءات الأخرى ما يلي:
  • ضبط مصابيحي على اللون الأخضر.
  • تغيير مصباح مكتبي إلى اللون الأحمر.