مخطط ميزة NetworkControl NetworkControl Network
action.devices.traits.NetworkControl
: تنتمي هذه السمة إلى الأجهزة التي توفّر ميزة إعداد التقارير عن بيانات الشبكة وتنفيذ العمليات المتعلّقة بالشبكة.
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
supportsEnablingGuestNetwork |
منطقي |
(القيمة التلقائية: اضبط على "true" إذا كان من الممكن تفعيل شبكة الضيوف. |
supportsDisablingGuestNetwork |
منطقي |
(القيمة التلقائية: اضبط على "true" إذا كان من الممكن إيقاف شبكة الضيوف. |
supportsGettingGuestNetworkPassword |
منطقي |
(القيمة التلقائية: اضبط هذه القيمة على "صحيح" إذا كان من الممكن الحصول على كلمة مرور شبكة الضيوف من خلال الأمر |
networkProfiles |
المصفوفة |
يشير إلى أسماء الملفات الشخصية المتوافقة على الشبكة. |
[item, ...] |
سلسلة |
اسم ملف شخصي للشبكة يمثل مجموعة من الأجهزة ذات الصلة. |
supportsEnablingNetworkProfile |
منطقي |
(القيمة التلقائية: اضبط على "true" إذا كان من الممكن تفعيل الملفات الشخصية للشبكة. |
supportsDisablingNetworkProfile |
منطقي |
(القيمة التلقائية: يمكنك التعيين على "true" إذا كان من الممكن تعطيل الملفات الشخصية للشبكة. |
supportsNetworkDownloadSpeedTest |
منطقي |
(القيمة التلقائية: اضبط على "true" إذا كان من الممكن تشغيل اختبار سرعة التنزيل. |
supportsNetworkUploadSpeedTest |
منطقي |
(القيمة التلقائية: اضبط القيمة على "true" إذا كان من الممكن تشغيل اختبار سرعة التحميل. |
أمثلة
جهاز شبكة يتوافق مع شبكة الضيوف والملفات الشخصية واختبار السرعة.
{ "supportsEnablingGuestNetwork": true, "supportsDisablingGuestNetwork": true, "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true, "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true, "supportsGettingGuestNetworkPassword": true, "networkProfiles": [ "kids" ] }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
networkEnabled |
منطقي |
ما إذا تم تفعيل الشبكة الرئيسية أم لا. |
networkSettings |
العنصر |
يحتوي على معرّف SSID للشبكة الرئيسية. |
ssid |
سلسلة |
مطلوبة. SSID للشبكة. |
guestNetworkEnabled |
منطقي |
ما إذا تم تفعيل شبكة الضيوف أم لا. |
guestNetworkSettings |
العنصر |
يحتوي على SSID لشبكة الضيف. |
ssid |
سلسلة |
مطلوبة. SSID للشبكة. |
numConnectedDevices |
عدد صحيح |
عدد الأجهزة المتصلة بالشبكة. |
networkUsageMB |
Number |
استخدام الشبكة بالميغابايت (ميغابايت). يندرج استخدام الشبكة ضمن المدة الزمنية الحالية للفوترة والتي يمكن الاستفادة منها في مراقبة حدود استخدام الشبكة لفترة الفوترة. |
networkUsageLimitMB |
Number |
حد استخدام الشبكة بالميغابايت (ميغابايت). يقع الحد الأقصى لاستخدام الشبكة خلال المدة الزمنية الحالية للفوترة. |
networkUsageUnlimited |
منطقي |
ما إذا كان استخدام الشبكة غير محدود. وسيتم تجاهل الشبكة UsageUsageLimitMB في حالة ضبط هذا الإعداد على true. |
lastNetworkDownloadSpeedTest |
العنصر |
يحتوي على نتائج أحدث اختبار لسرعة تنزيل الشبكة. |
downloadSpeedMbps |
Number |
سرعة التنزيل بالميغابايت في الثانية (ميغابايت في الثانية) من آخر اختبار لسرعة الشبكة. |
unixTimestampSec |
عدد صحيح |
الطابع الزمني لنظام التشغيل Unix (عدد الثواني منذ حقبة Unix Epoch) للوقت الذي تم فيه إجراء آخر اختبار لسرعة تنزيل الشبكة. |
status |
سلسلة |
يشير إلى ما إذا كانت عملية اختبار سرعة التنزيل الأخيرة للشبكة قد تمت بنجاح أم لا. القيم المسموح بها:
|
lastNetworkUploadSpeedTest |
العنصر |
يحتوي على نتائج أحدث اختبار لسرعة تحميل الشبكة. |
uploadSpeedMbps |
Number |
سرعة التحميل بالميغابايت في الثانية (ميغابايت في الثانية) من آخر اختبار لسرعة الشبكة. |
unixTimestampSec |
عدد صحيح |
الطابع الزمني لـ Unix (عدد الثواني منذ حقبة Unix) الذي تم خلاله تشغيل آخر اختبار لسرعة تحميل الشبكة. |
status |
سلسلة |
يشير هذا الحقل إلى ما إذا كان اختبار سرعة تحميل الشبكة الأخير قد نجح أم لا. القيم المسموح بها:
|
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 } } }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE
، يُرجى الاطّلاع على تنفيذ الإجراء.
action.devices.commands.EnableDisableGuestNetwork
تمكين شبكة الضيف أو تعطيلها. يجب استخدام طريقة التحقُّق الثانوية للمستخدم باستخدام رقم التعريف الشخصي. يمكن اعتبار أمان منزل المستخدم متأثرًا إذا تم إيقاف أجهزة الأمان الأخرى من خلال هذه الأوامر.
يتطلب هذا الأمر السمات التالية:{ "supportsEnablingGuestNetwork": true, "supportsDisablingGuestNetwork": true }
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
enable |
منطقي |
مطلوبة. True لتفعيل شبكة الضيوف، وfalse لتعطيل شبكة الضيف. |
أمثلة
تفعيل شبكة الضيوف.
{ "command": "action.devices.commands.EnableDisableGuestNetwork", "params": { "enable": true } }
action.devices.commands.EnableDisableNetworkProfile
تمكين أو تعطيل الملف الشخصي للشبكة. يجب استخدام طريقة التحقُّق الثانوية للمستخدم باستخدام رقم التعريف الشخصي. يمكن اعتبار أمان منزل المستخدم متأثرًا إذا تم إيقاف أجهزة الأمان الأخرى من خلال هذه الأوامر.
يتطلب هذا الأمر السمات التالية:{ "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true }
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
profile |
سلسلة |
مطلوبة. اسم الملف الشخصي من السمة |
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 |
سلسلة |
مطلوبة. كلمة المرور لشبكة الضيوف. |
أمثلة
عرض كلمة مرور شبكة Wi-Fi للضيوف.
{ "guestNetworkPassword": "123456" }
action.devices.commands.TestNetworkSpeed
اختبر سرعة التنزيل والتحميل على الشبكة.
يتطلب هذا الأمر السمات التالية:{ "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true }
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
testDownloadSpeed |
منطقي |
مطلوبة. يشير هذا الإعداد إلى ما إذا كان يجب اختبار سرعة التنزيل أم لا. |
testUploadSpeed |
منطقي |
مطلوبة. لتحديد ما إذا كان يجب اختبار سرعة التحميل أم لا. |
followUpToken |
سلسلة |
مطلوبة. رمز مميز تقدمه Google للرد على المتابعة. |
أمثلة
ما هي سرعة Wi-Fi؟
{ "command": "action.devices.commands.TestNetworkSpeed", "params": { "testDownloadSpeed": true, "testUploadSpeed": true, "followUpToken": "123" } }
الأخطاء ذات الصلة
حدث خطأ أثناء محاولة طلب اختبار السرعة.
القيم المسموح بها:
networkSpeedTestInProgress
ردود المتابعة
قد تعرض الأجهزة التي تتضمّن هذه السمة حمولة الاستجابة التالية في إطار عملية EXECUTE
. لمزيد من المعلومات حول تنفيذ ردود المتابعة، يُرجى الاطّلاع على إشعارات الإجراءات المنزلية الذكية.
تحتوي الحمولة على واحد مما يلي:
نجاح: networkDownloadSpeedSpeed
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
سلسلة |
مطلوبة. تم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
سلسلة |
مطلوبة. نتيجة الطلب. القيم المسموح بها:
|
networkDownloadSpeedMbps |
Number |
مطلوبة. يتم قياس سرعة تنزيل الشبكة بالميغابت في الثانية. |
تم بنجاح: networkUploadSpeedSpeed
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
سلسلة |
مطلوبة. تم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
سلسلة |
مطلوبة. نتيجة الطلب. القيم المسموح بها:
|
networkUploadSpeedMbps |
Number |
مطلوبة. تبلغ سرعة تحميل الشبكة بالميغابت في الثانية. |
نجاح: networkDownloadSpeedSpeed وnetworkUploadSpeed ميغابت في الثانية
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
سلسلة |
مطلوبة. تم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
سلسلة |
مطلوبة. نتيجة الطلب. القيم المسموح بها:
|
networkDownloadSpeedMbps |
Number |
مطلوبة. يتم قياس سرعة تنزيل الشبكة بالميغابت في الثانية. |
networkUploadSpeedMbps |
Number |
مطلوبة. تبلغ سرعة تحميل الشبكة بالميغابت في الثانية. |
تعذّر الإجراء
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
سلسلة |
مطلوبة. تم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
سلسلة |
مطلوبة. نتيجة الطلب. القيم المسموح بها:
|
errorCode |
سلسلة |
مطلوبة. يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثل |
أمثلة
ما هي سرعة 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