مخطط سمة "التحكّم بالشبكة المنزلية الذكية"
action.devices.traits.NetworkControl
: تنتمي هذه السمة إلى أجهزة تتيح إعداد تقارير عن بيانات الشبكة وإجراء عمليات خاصة بالشبكة.
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات
التالية كجزء من عملية SYNC
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في SYNC
، يُرجى الاطّلاع على تنفيذ النية بالشراء.
السمات | Type | الوصف |
---|---|---|
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
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر 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 |
يشير إلى ما إذا كانت نتيجة اختبار سرعة التنزيل الأخير للشبكة ناجحة أم لا. القيم المسموح بها:
|
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 }
جهاز تم إيقاف الملف الشخصي للشبكة "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 |
مطلوب: اسم الملف الشخصي من السمة |
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 |
مطلوب: نتيجة الطلب القيم المسموح بها:
|
networkDownloadSpeedMbps |
Number |
مطلوب: سرعة تنزيل الشبكة التي يتم قياسها بالميغابت في الثانية |
تم بنجاح: networkUploadSpeedSpeedMbps
الحقول | Type | الوصف |
---|---|---|
followUpToken |
String |
مطلوب: الرمز المميّز المقدَّم في طلب EXECUTE الأصلي |
status |
String |
مطلوب: نتيجة الطلب القيم المسموح بها:
|
networkUploadSpeedMbps |
Number |
مطلوب: سرعة تحميل الشبكة التي يتم قياسها بالميغابت في الثانية |
نجاح: networkDownloadSpeedMbps وnetworkUploadSpeedMbps
الحقول | Type | الوصف |
---|---|---|
followUpToken |
String |
مطلوب: الرمز المميّز المقدَّم في طلب EXECUTE الأصلي |
status |
String |
مطلوب: نتيجة الطلب القيم المسموح بها:
|
networkDownloadSpeedMbps |
Number |
مطلوب: سرعة تنزيل الشبكة التي يتم قياسها بالميغابت في الثانية |
networkUploadSpeedMbps |
Number |
مطلوب: سرعة تحميل الشبكة التي يتم قياسها بالميغابت في الثانية |
تعذّر الإجراء
الحقول | Type | الوصف |
---|---|---|
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