مخطط سمة التحكم في الشبكة في المنزل المزوّد بأجهزة ذكية
action.devices.traits.NetworkControl
: تنتمي هذه السمة إلى الأجهزة التي تتيح الإبلاغ عن بيانات الشبكة وإجراء عمليات خاصة بالشبكة.
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات عن التعامل مع أغراض SYNC
، يُرجى الاطّلاع على تنفيذ النية.
السمات | النوع | الوصف |
---|---|---|
supportsEnablingGuestNetwork |
منطقية |
(القيمة التلقائية: اضبطه على "صحيح" إذا كان من الممكن تفعيل شبكة الضيف. |
supportsDisablingGuestNetwork |
منطقية |
(القيمة التلقائية: اضبطه على "صحيح" إذا كان من الممكن إيقاف شبكة الضيف. |
supportsGettingGuestNetworkPassword |
منطقية |
(القيمة التلقائية: اضبط هذه القيمة على "صحيح" إذا كان من الممكن الحصول على كلمة مرور شبكة الضيف من خلال الأمر |
networkProfiles |
صفيف |
تشير إلى أسماء الملفات الشخصية للشبكة المتوافقة. |
[item, ...] |
String |
اسم ملف شخصي للشبكة يمثل مجموعة من الأجهزة ذات الصلة. |
supportsEnablingNetworkProfile |
منطقية |
(القيمة التلقائية: يمكنك ضبطه على "صحيح" في حال كان من الممكن تفعيل الملفات الشخصية للشبكة. |
supportsDisablingNetworkProfile |
منطقية |
(القيمة التلقائية: يمكنك ضبطه على "صحيح" في حال كان من الممكن إيقاف الملفات الشخصية للشبكة. |
supportsNetworkDownloadSpeedTest |
منطقية |
(القيمة التلقائية: اضبطها على "صحيح" إذا كان من الممكن إجراء اختبار لسرعة التنزيل. |
supportsNetworkUploadSpeedTest |
منطقية |
(القيمة التلقائية: اضبطها على "صحيح" إذا كان من الممكن إجراء اختبار لسرعة التحميل. |
أمثلة
جهاز شبكة متوافق مع شبكة الضيوف والملفات الشخصية واختبار السرعة
{ "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 |
تشير هذه السمة إلى ما إذا كانت آخر عملية اختبار لسرعة تنزيل الشبكة قد نجحت أو تعذّر إجراؤها. القيم المسموح بها:
|
lastNetworkUploadSpeedTest |
كائن |
يحتوي على نتائج آخر اختبار لسرعة التحميل عبر الشبكة. |
uploadSpeedMbps |
Number |
سرعة التحميل بالميغابت في الثانية التي تم اختبارها في آخر اختبار لسرعة الشبكة. |
unixTimestampSec |
عدد صحيح |
الطابع الزمني لـ Unix (عدد الثواني منذ حقبة Unix) لوقت إجراء آخر اختبار لسرعة التحميل على الشبكة |
status |
String |
يشير إلى ما إذا كان آخر اختبار لسرعة التحميل عبر الشبكة قد نجح أم تعذّر. القيم المسموح بها:
|
networkSpeedTestInProgress |
منطقية |
(القيمة التلقائية: ما إذا كان يتم حاليًا إجراء اختبار سرعة. |
networkProfilesState |
كائن |
حالة للملفات الشخصية على الشبكة. يجب أن يحتوي عنصر المستوى الأعلى هذا على أزواج مفاتيح، حيث يكون المفتاح هو اسم أحد الملفات الشخصية للشبكة المُدرَجة في السمة |
<string> |
كائن |
يشير ذلك المصطلح إلى كائن يخزِّن حالة ملف شخصي فردي للشبكة. يجب أن تكون قيمة المفتاح |
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 |
يجب ملء هذا الحقل. اسم الملف الشخصي من السمة |
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 |
يجب ملء هذا الحقل. نتيجة الطلب القيم المسموح بها:
|
networkDownloadSpeedMbps |
Number |
يجب ملء هذا الحقل. سرعة تنزيل الشبكة، مُقاسة بالميغابت في الثانية |
نجاح: networkUploadSpeedوسع ميغابت في الثانية
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
String |
يجب ملء هذا الحقل. يتم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
String |
يجب ملء هذا الحقل. نتيجة الطلب القيم المسموح بها:
|
networkUploadSpeedMbps |
Number |
يجب ملء هذا الحقل. سرعة تحميل الشبكة، ويتم قياسها بالميغابت في الثانية. |
نجاح: networkDownloadSpeed ميغابت وnetworkUploadSpeedSpeed
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
String |
يجب ملء هذا الحقل. يتم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
String |
يجب ملء هذا الحقل. نتيجة الطلب القيم المسموح بها:
|
networkDownloadSpeedMbps |
Number |
يجب ملء هذا الحقل. سرعة تنزيل الشبكة، مُقاسة بالميغابت في الثانية |
networkUploadSpeedMbps |
Number |
يجب ملء هذا الحقل. سرعة تحميل الشبكة، ويتم قياسها بالميغابت في الثانية. |
تعذّر الإجراء
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
String |
يجب ملء هذا الحقل. يتم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
String |
يجب ملء هذا الحقل. نتيجة الطلب القيم المسموح بها:
|
errorCode |
String |
يجب ملء هذا الحقل. يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثلاً |
أمثلة
ما هي سرعة شبكة 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