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

action.devices.traits.NetworkControl - تنتمي هذه السمة إلى الأجهزة التي تدعم الإبلاغ عن بيانات الشبكة وتنفيذ العمليات المتعلقة بالشبكة.

ATTRIBUTES للجهاز

يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي: كجزء من عملية 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 الخاصة بحالة الجهاز في حال ضبط هذه السياسة على "صحيح".
lastNetworkDownloadSpeedTest كائن

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

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

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

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

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

SUCCESS
FAILURE
lastNetworkUploadSpeedTest كائن

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

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

الطابع الزمني لنظام التشغيل Unix (عدد الثواني منذ بدء نظام Unix Epoch) لمعرفة الوقت الذي تمّ فيه إجراء آخر اختبار لسرعة التحميل على الشبكة
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
    }
  }
}

CommandS للجهاز

قد تستجيب الأجهزة التي تتضمن هذه السمة لما يلي: الأوامر كجزء من عملية 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 منطقي

يجب ملء هذا الحقل.

على "صحيح" لتفعيل الملف الشخصي، وعلى "خطأ" لإيقاف الملف الشخصي.

أمثلة

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

{
  "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

يجب ملء هذا الحقل.

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

نجاح: تحميل الشبكة بمعدل ميغابت في الثانية

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