مخطط سمة التحكم في الشبكة في المنزل المزوّد بأجهزة ذكية

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

سمات الجهاز

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

السمات	النوع	الوصف
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. لمزيد من المعلومات عن التعامل مع أغراض QUERY، يُرجى الاطّلاع على تنفيذ النية.

الولايات	النوع	الوصف
networkEnabled	منطقية	ما إذا كانت الشبكة الرئيسية مفعَّلة.
networkSettings	كائن	يحتوي على معرّف SSID للشبكة الرئيسية.
ssid	String	يجب ملء هذا الحقل. معرّف SSID للشبكة.
guestNetworkEnabled	منطقية	ما إذا كانت شبكة الضيف مفعَّلة.
guestNetworkSettings	كائن	يحتوي على SSID لشبكة الضيف
ssid	String	يجب ملء هذا الحقل. معرّف SSID للشبكة.
numConnectedDevices	عدد صحيح	عدد الأجهزة المتصلة بالشبكة.
networkUsageMB	Number	استخدام الشبكة بالميغابايت (ميغابايت). يكون استخدام الشبكة خلال المدة الزمنية الحالية للفوترة، مما قد يكون مفيدًا للمراقبة في ما يتعلق بحد استخدام الشبكة للمدة الزمنية للفوترة.
networkUsageLimitMB	Number	حد استخدام الشبكة بالميغابايت (ميغابايت). يقع الحدّ الأقصى لاستخدام الشبكة ضمن المدة الزمنية الحالية للفوترة.
networkUsageUnlimited	منطقية	ما إذا كان استخدام الشبكة غير محدود أم لا. سيتم تجاهل حالة الجهاز networkUsagelimitMB في حال ضبط هذه السياسة على true.
lastNetworkDownloadSpeedTest	كائن	يحتوي على نتائج أحدث اختبار لسرعة التنزيل في الشبكة.
downloadSpeedMbps	Number	سرعة التنزيل بالميغابت في الثانية من آخر اختبار لسرعة الشبكة.
unixTimestampSec	عدد صحيح	الطابع الزمني لـ Unix (عدد الثواني منذ حقبة Unix) لوقت إجراء آخر اختبار لسرعة تنزيل الشبكة.
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
}

الجهاز الذي تم إيقاف علامة NetworkProfile عليه "للأطفال"

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

مفاتيح الجهاز

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

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	منطقية	يجب ملء هذا الحقل. انقر على "true" لتفعيل الملف الشخصي وعلى "false" لإيقاف الملف الشخصي.

أمثلة

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

{
  "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. لمعرفة مزيد من المعلومات حول تنفيذ استجابات المتابعة، يمكنك الاطّلاع على إشعارات إجراءات المنزل المزوّد بأجهزة ذكية.

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

نجاح: networkDownloadSpeed ميغابت

الحقول	النوع	الوصف
followUpToken	String	يجب ملء هذا الحقل. يتم تقديم الرمز المميز في طلب EXECUTE الأصلي.
status	String	يجب ملء هذا الحقل. نتيجة الطلب القيم المسموح بها: SUCCESS
networkDownloadSpeedMbps	Number	يجب ملء هذا الحقل. سرعة تنزيل الشبكة، مُقاسة بالميغابت في الثانية

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

الحقول	النوع	الوصف
followUpToken	String	يجب ملء هذا الحقل. يتم تقديم الرمز المميز في طلب EXECUTE الأصلي.
status	String	يجب ملء هذا الحقل. نتيجة الطلب القيم المسموح بها: SUCCESS
networkUploadSpeedMbps	Number	يجب ملء هذا الحقل. سرعة تحميل الشبكة، ويتم قياسها بالميغابت في الثانية.

نجاح: networkDownloadSpeed ميغابت وnetworkUploadSpeedSpeed

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