مخطط سمة "التحكّم بالشبكة المنزلية الذكية"

action.devices.traits.NetworkControl: تنتمي هذه السمة إلى أجهزة تتيح إعداد تقارير عن بيانات الشبكة وإجراء عمليات خاصة بالشبكة.

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في SYNC، يُرجى الاطّلاع على تنفيذ النية بالشراء.

السمات Type الوصف
supportsEnablingGuestNetwork منطقي

(تلقائي: false)

اضبط على "صحيح" إذا كان من الممكن تفعيل شبكة الضيوف.
supportsDisablingGuestNetwork منطقي

(تلقائي: false)

اضبط على "صحيح" إذا كان من الممكن إيقاف شبكة الضيوف.
supportsGettingGuestNetworkPassword منطقي

(تلقائي: false)

يمكنك ضبطها على "صحيح" إذا كان يمكن الحصول على كلمة مرور شبكة الضيوف من خلال الأمر GetGuestNetworkPassword.
networkProfiles مصفوفة

يشير إلى أسماء الملفات الشخصية المتوافقة للشبكة.
[item, ...] String

اسم الملف الشخصي للشبكة الذي يمثّل مجموعة من الأجهزة ذات الصلة
supportsEnablingNetworkProfile منطقي

(تلقائي: "false")

يتم ضبطها على "صحيح" إذا كان من الممكن تفعيل الملفات الشخصية للشبكة.
supportsDisablingNetworkProfile منطقي

(تلقائي: "false")

يتم ضبطها على "صحيح" إذا كان من الممكن إيقاف الملفات الشخصية للشبكة.
supportsNetworkDownloadSpeedTest منطقي

(تلقائي: false)

يتم ضبطها على "صحيح" إذا كان بالإمكان تشغيل اختبار سرعة التنزيل.
supportsNetworkUploadSpeedTest منطقي

(تلقائي: false)

يتم ضبطها على "صحيح" إذا كان بالإمكان تشغيل اختبار سرعة التحميل.

أمثلة

جهاز شبكة يتوافق مع شبكة الضيف والملفات الشخصية واختبار السرعة.

{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true,
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true,
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true,
  "supportsGettingGuestNetworkPassword": true,
  "networkProfiles": [
    "Kids"
  ]
}

حالات الجهاز

قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

الولايات Type الوصف
networkEnabled منطقي

ما إذا كانت الشبكة الرئيسية مفعَّلة.
networkSettings العنصر

يحتوي على معرّف SSID للشبكة الرئيسية.
ssid String

مطلوب:

معرّف SSID للشبكة.
guestNetworkEnabled منطقي

ما إذا تم تفعيل شبكة الضيوف.
guestNetworkSettings العنصر

يحتوي على معرّف SSID لشبكة الضيوف.
ssid String

مطلوب:

معرّف SSID للشبكة.
numConnectedDevices عدد صحيح

عدد الأجهزة المتصلة بالشبكة.
networkUsageMB Number

استخدام الشبكة بالميغابايت (ميغابايت) يندرج استخدام الشبكة ضمن المدة الزمنية الحالية للفوترة، ما قد يكون مفيدًا في ما يتعلّق بالحدّ الأقصى المسموح به لاستخدام الشبكة في المدة الزمنية للفوترة.
networkUsageLimitMB Number

حد استخدام الشبكة بالميغابايت يقع حد استخدام الشبكة ضمن المدة الزمنية الحالية للفوترة.
networkUsageUnlimited منطقي

استخدام الشبكة بلا حدود وسيتم تجاهل حالة networkUsagelimitMB إذا تم ضبط هذه السياسة على "صحيح".
lastNetworkDownloadSpeedTest العنصر

يحتوي على نتائج آخر اختبار لسرعة تنزيل الشبكة.
downloadSpeedMbps Number

سرعة التنزيل بالميغابت في الثانية (ميغابايت في الثانية) من آخر اختبار لسرعة الشبكة
unixTimestampSec عدد صحيح

الطابع الزمني لنظام التشغيل Unix (عدد الثواني منذ حقبة Unix Epoch) للوقت الذي تم فيه إجراء آخر اختبار لسرعة تنزيل الشبكة.
status String

يشير إلى ما إذا كانت نتيجة اختبار سرعة التنزيل الأخير للشبكة ناجحة أم لا.

القيم المسموح بها:

SUCCESS
FAILURE
lastNetworkUploadSpeedTest العنصر

يحتوي على نتائج آخر اختبار لسرعة تحميل الشبكة.
uploadSpeedMbps Number

سرعة التحميل بالميغابت في الثانية (ميغابايت في الثانية) من آخر اختبار لسرعة الشبكة
unixTimestampSec عدد صحيح

الطابع الزمني لنظام التشغيل Unix (عدد الثواني منذ آخر حقبة Unix) لوقت تشغيل آخر اختبار لسرعة تحميل الشبكة
status String

يشير إلى ما إذا كانت نتيجة آخر اختبار لسرعة تحميل الشبكة هي "تعذّر" أم لا.

القيم المسموح بها:

SUCCESS
FAILURE
networkSpeedTestInProgress منطقي

(تلقائي: false)

ما إذا كان اختبار السرعة يجري حاليًا
networkProfilesState العنصر

حالة الملفات الشخصية للشبكة يجب أن يحتوي كائن المستوى الأعلى هذا على أزواج قيم/مفاتيح حيث يكون المفتاح أحد أسماء الملفات الشخصية للشبكة المُدرَجة في السمة networkProfiles وأن تكون القيمة هي الحالة المقابلة لهذا الملف الشخصي.
<string> العنصر

عنصر يخزّن حالة الملف الشخصي الفردي للشبكة. يجب أن تكون قيمة المفتاح هي اسم أحد الملفات الشخصية للشبكة في السمة networkProfiles.
enabled منطقي

الحالة المفعّلة/المتوقّفة الحالية للملف الشخصي على الشبكة

أمثلة

الجهاز الذي يتضمّن شبكة نشطة.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8
}

جهاز يتضمّن شبكة نشطة واختبارات سرعة.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "lastNetworkDownloadSpeedTest": {
    "downloadSpeedMbps": 159.8,
    "unixTimestampSec": 1563215576,
    "status": "SUCCESS"
  },
  "lastNetworkUploadSpeedTest": {
    "uploadSpeedMbps": 64.1,
    "unixTimestampSec": 1563215576,
    "status": "SUCCESS"
  }
}

الجهاز المزوّد بشبكة نشطة وأداة اختبار السرعة قيد التقدّم.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "networkSpeedTestInProgress": true
}

جهاز تم إيقاف الملف الشخصي للشبكة "kids" فيه.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "networkProfilesState": {
    "parents": {
      "enabled": true
    },
    "kids": {
      "enabled": false
    }
  }
}

حوالات الجهاز

قد تستجيب الأجهزة التي تستخدم هذه السمة للأوامر التالية كجزء من عملية EXECUTE. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في EXECUTE، يُرجى الاطّلاع على تنفيذ النية بالشراء.

action.devices.commands.EnableDisableGuestNetwork

فعِّل شبكة الضيوف أو أوقِفها. يجب استخدام عملية إثبات هوية المستخدم الثانوي باستخدام رقم التعريف الشخصي. ويمكن اعتبار أمان المنزل للمستخدم متأثرًا إذا تم إيقاف أجهزة الأمان الأخرى من خلال هذه الأوامر.

يتطلب هذا الأمر السمات التالية: 
{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true
}

المَعلمات

المَعلمات Type الوصف
enable منطقي

مطلوب:

صحيح لتفعيل شبكة الضيوف، وعلى "خطأ" لإيقاف شبكة الضيوف.

أمثلة

فعِّل شبكة الضيوف.

{
  "command": "action.devices.commands.EnableDisableGuestNetwork",
  "params": {
    "enable": true
  }
}

action.devices.commands.EnableDisableNetworkProfile

تفعيل ملف شخصي للشبكة أو إيقافه يجب استخدام عملية إثبات هوية المستخدم الثانوي باستخدام رقم التعريف الشخصي. ويمكن اعتبار أمان المنزل للمستخدم متأثرًا إذا تم إيقاف أجهزة الأمان الأخرى من خلال هذه الأوامر.

يتطلب هذا الأمر السمات التالية: 
{
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true
}

المَعلمات

المَعلمات Type الوصف
profile String

مطلوب:

اسم الملف الشخصي من السمة networkProfiles
enable منطقي

مطلوب:

صحيح لتفعيل الملف الشخصي، يتم استخدام خطأ على إيقاف الملف الشخصي.

أمثلة

إيقاف الإنترنت للأطفال

{
  "command": "action.devices.commands.EnableDisableNetworkProfile",
  "params": {
    "profile": "Kids",
    "enable": false
  }
}

حدث خطأ أثناء محاولة التحكم في الملف الشخصي للشبكة.

القيم المسموح بها:

networkProfileNotRecognized

action.devices.commands.GetGuestNetworkPassword

الحصول على كلمة مرور شبكة الضيوف يجب استخدام عملية إثبات هوية المستخدم الثانوي باستخدام رقم التعريف الشخصي. ويمكن اعتبار أمان المنزل للمستخدم متأثرًا إذا تم إيقاف أجهزة الأمان الأخرى من خلال هذه الأوامر.

يتطلب هذا الأمر السمات التالية: 
{
  "supportsGettingGuestNetworkPassword": true
}

المَعلمات

المَعلمات Type الوصف

ما من مواقع

أمثلة

عرض كلمة مرور شبكة Wi-Fi للضيوف.

{
  "command": "action.devices.commands.GetGuestNetworkPassword",
  "params": {}
}

النتائج

النتائج Type الوصف
guestNetworkPassword String

مطلوب:

كلمة مرور شبكة الضيوف.

أمثلة

عرض كلمة مرور شبكة Wi-Fi للضيوف.

{
  "guestNetworkPassword": "123456"
}

action.devices.commands.TestNetworkSpeed

اختبار سرعة التنزيل والتحميل على الشبكة

يتطلب هذا الأمر السمات التالية: 
{
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true
}

المَعلمات

المَعلمات Type الوصف
testDownloadSpeed منطقي

مطلوب:

تحدِّد هذه السياسة ما إذا كان يجب اختبار سرعة التنزيل.
testUploadSpeed منطقي

مطلوب:

تحدّد هذه السياسة ما إذا كان يجب اختبار سرعة التحميل.
followUpToken String

مطلوب:

الرمز المميّز الذي تقدمه Google للرد على المتابعة

أمثلة

ما هي سرعة Wi-Fi؟

{
  "command": "action.devices.commands.TestNetworkSpeed",
  "params": {
    "testDownloadSpeed": true,
    "testUploadSpeed": true,
    "followUpToken": "123"
  }
}

حدث خطأ أثناء محاولة طلب اختبار السرعة.

القيم المسموح بها:

networkSpeedTestInProgress

ردود المتابعة

قد تعرض الأجهزة التي تتضمّن هذه السمة حمولة الاستجابة التالية كجزء من عملية EXECUTE. ولمزيد من المعلومات حول تنفيذ استجابات المتابعة، يُرجى الاطّلاع على إشعارات الإجراءات المنزلية الذكية.

تحتوي الحمولة على أحد العناصر التالية:

نجاح: networkDownloadSpeedMbps

الحقول Type الوصف
followUpToken String

مطلوب:

الرمز المميّز المقدَّم في طلب EXECUTE الأصلي
status String

مطلوب:

نتيجة الطلب

القيم المسموح بها:

SUCCESS
networkDownloadSpeedMbps Number

مطلوب:

سرعة تنزيل الشبكة التي يتم قياسها بالميغابت في الثانية

تم بنجاح: networkUploadSpeedSpeedMbps

الحقول Type الوصف
followUpToken String

مطلوب:

الرمز المميّز المقدَّم في طلب EXECUTE الأصلي
status String

مطلوب:

نتيجة الطلب

القيم المسموح بها:

SUCCESS
networkUploadSpeedMbps Number

مطلوب:

سرعة تحميل الشبكة التي يتم قياسها بالميغابت في الثانية

نجاح: networkDownloadSpeedMbps وnetworkUploadSpeedMbps

الحقول Type الوصف
followUpToken String

مطلوب:

الرمز المميّز المقدَّم في طلب EXECUTE الأصلي
status String

مطلوب:

نتيجة الطلب

القيم المسموح بها:

SUCCESS
networkDownloadSpeedMbps Number

مطلوب:

سرعة تنزيل الشبكة التي يتم قياسها بالميغابت في الثانية
networkUploadSpeedMbps Number

مطلوب:

سرعة تحميل الشبكة التي يتم قياسها بالميغابت في الثانية

تعذّر الإجراء

الحقول Type الوصف
followUpToken String

مطلوب:

الرمز المميّز المقدَّم في طلب EXECUTE الأصلي
status String

مطلوب:

نتيجة الطلب

القيم المسموح بها:

FAILURE
errorCode String

مطلوب:

يمكن أن تكون القيمة أيّ رمز خطأ لهذه السمة، مثلاً، transientError.

أمثلة

ما هي سرعة Wi-Fi؟ (متابعة الرد)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "networkDownloadSpeedMbps": 23.3,
      "networkUploadSpeedMbps": 10.2,
      "followUpToken": "1234"
    }
  }
}

ما هي سرعة Wi-Fi؟ (تعذّر الرد على المتابعة)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "transientError",
      "followUpToken": "1234"
    }
  }
}

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.

حدث خطأ أثناء محاولة التحكم في الملف الشخصي للشبكة.

القيم المسموح بها:

networkProfileNotRecognized

حدث خطأ أثناء محاولة طلب اختبار السرعة.

القيم المسموح بها:

networkSpeedTestInProgress