مخطّط سمة NetworkControl للمنزل الذكي

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

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. للاطّلاع على مزيد من المعلومات عن معالجة SYNC intents، اطّلِع على تلبية النية.

السمات النوع الوصف
supportsEnablingGuestNetwork صحيح/خطأ

(القيمة التلقائية: false)

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

(القيمة التلقائية: false)

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

(القيمة التلقائية: false)

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

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

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

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

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

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

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

(القيمة التلقائية: false)

اضبط القيمة على true إذا كان بالإمكان إجراء اختبار سرعة تنزيل.
supportsNetworkUploadSpeedTest صحيح/خطأ

(القيمة التلقائية: false)

اضبط القيمة على true إذا كان بالإمكان إجراء اختبار لسرعة التحميل.

أمثلة

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

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

حالات الجهاز

يمكن أن تُبلغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات عن معالجة QUERY intents، اطّلِع على تلبية النية.

الولايات النوع الوصف
networkEnabled صحيح/خطأ

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

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

مطلوبة

معرّف SSID للشبكة
guestNetworkEnabled صحيح/خطأ

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

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

مطلوبة

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

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

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

حدّ استخدام الشبكة بوحدة القياس ميغابايت أنّ حدّ استخدام الشبكة يقع ضمن مدة الفوترة الحالية
networkUsageUnlimited صحيح/خطأ

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

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

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

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

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

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

SUCCESS
FAILURE
lastNetworkUploadSpeedTest العنصر

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

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

الطابع الزمني لنظام التشغيل 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
}

الجهاز الذي تم إيقاف ملف الشبكة "الأطفال" فيه

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

أوامر الجهاز

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

action.devices.commands.EnableDisableGuestNetwork

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

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

المعلمات

المعلمات النوع الوصف
enable صحيح/خطأ

مطلوبة

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

أمثلة

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

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

action.devices.commands.EnableDisableNetworkProfile

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

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

المعلمات

المعلمات النوع الوصف
profile String

مطلوبة

اسم الملف الشخصي من سمة networkProfiles
enable صحيح/خطأ

مطلوبة

صحيح لتفعيل الملف الشخصي، خطأ لإيقافه

أمثلة

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

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

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

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

networkProfileNotRecognized

action.devices.commands.GetGuestNetworkPassword

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

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

المعلمات

المعلمات النوع الوصف

ما من مواقع

أمثلة

عرض كلمة مرور شبكة Wi-Fi الخاصة بالضيوف

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

النتائج

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

مطلوبة

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

أمثلة

عرض كلمة مرور شبكة Wi-Fi الخاصة بالضيوف

{
  "guestNetworkPassword": "123456"
}

action.devices.commands.TestNetworkSpeed

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

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

المعلمات

المعلمات النوع الوصف
testDownloadSpeed صحيح/خطأ

مطلوبة

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

مطلوبة

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

مطلوبة

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

أمثلة

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

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

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

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

networkSpeedTestInProgress

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

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

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

الحالة: networkDownloadSpeedMbps

الحقول النوع الوصف
followUpToken String

مطلوبة

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

مطلوبة

نتيجة الطلب

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

SUCCESS
networkDownloadSpeedMbps Number

مطلوبة

سرعة تنزيل المحتوى من الشبكة تُقاس بالميغابت في الثانية.

الحالة: networkUploadSpeedMbps

الحقول النوع الوصف
followUpToken String

مطلوبة

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

مطلوبة

نتيجة الطلب

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

SUCCESS
networkUploadSpeedMbps Number

مطلوبة

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

الحالة: سرعة التنزيل بالميغابت في الثانية وسرعة التحميل بالميغابت في الثانية

الحقول النوع الوصف
followUpToken String

مطلوبة

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

مطلوبة

نتيجة الطلب

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

SUCCESS
networkDownloadSpeedMbps Number

مطلوبة

سرعة تنزيل المحتوى من الشبكة تُقاس بالميغابت في الثانية.
networkUploadSpeedMbps Number

مطلوبة

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

حالة تعذُّر إتمام العملية

الحقول النوع الوصف
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