مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مخطط ميزة NetworkControl NetworkControl Network

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

الجهاز ATTRIBUTES

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

السمات النوع الوصف
supportsEnablingGuestNetwork منطقي

(القيمة التلقائية: false)

اضبط على "true" إذا كان من الممكن تفعيل شبكة الضيوف.

supportsDisablingGuestNetwork منطقي

(القيمة التلقائية: false)

اضبط على "true" إذا كان من الممكن إيقاف شبكة الضيوف.

supportsGettingGuestNetworkPassword منطقي

(القيمة التلقائية: false)

اضبط هذه القيمة على "صحيح" إذا كان من الممكن الحصول على كلمة مرور شبكة الضيوف من خلال الأمر GetGuestNetworkPassword.

networkProfiles المصفوفة

يشير إلى أسماء الملفات الشخصية المتوافقة على الشبكة.

[item, ...] سلسلة

اسم ملف شخصي للشبكة يمثل مجموعة من الأجهزة ذات الصلة.

supportsEnablingNetworkProfile منطقي

(القيمة التلقائية: "false")

اضبط على "true" إذا كان من الممكن تفعيل الملفات الشخصية للشبكة.

supportsDisablingNetworkProfile منطقي

(القيمة التلقائية: "false")

يمكنك التعيين على "true" إذا كان من الممكن تعطيل الملفات الشخصية للشبكة.

supportsNetworkDownloadSpeedTest منطقي

(القيمة التلقائية: false)

اضبط على "true" إذا كان من الممكن تشغيل اختبار سرعة التنزيل.

supportsNetworkUploadSpeedTest منطقي

(القيمة التلقائية: false)

اضبط القيمة على "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 سلسلة

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

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

SUCCESS
FAILURE
lastNetworkUploadSpeedTest العنصر

يحتوي على نتائج أحدث اختبار لسرعة تحميل الشبكة.

uploadSpeedMbps Number

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

unixTimestampSec عدد صحيح

الطابع الزمني لـ Unix (عدد الثواني منذ حقبة Unix) الذي تم خلاله تشغيل آخر اختبار لسرعة تحميل الشبكة.

status سلسلة

يشير هذا الحقل إلى ما إذا كان اختبار سرعة تحميل الشبكة الأخير قد نجح أم لا.

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

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
    }
  }
}

مفاتيح 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 سلسلة

مطلوبة.

اسم الملف الشخصي من السمة 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 سلسلة

مطلوبة.

كلمة المرور لشبكة الضيوف.

أمثلة

عرض كلمة مرور شبكة 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 سلسلة

مطلوبة.

نتيجة الطلب.

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

SUCCESS
networkDownloadSpeedMbps Number

مطلوبة.

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

تم بنجاح: networkUploadSpeedSpeed

الحقول النوع الوصف
followUpToken سلسلة

مطلوبة.

تم تقديم الرمز المميز في طلب EXECUTE الأصلي.

status سلسلة

مطلوبة.

نتيجة الطلب.

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

SUCCESS
networkUploadSpeedMbps Number

مطلوبة.

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

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

الحقول النوع الوصف
followUpToken سلسلة

مطلوبة.

تم تقديم الرمز المميز في طلب EXECUTE الأصلي.

status سلسلة

مطلوبة.

نتيجة الطلب.

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

SUCCESS
networkDownloadSpeedMbps Number

مطلوبة.

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

networkUploadSpeedMbps Number

مطلوبة.

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

تعذّر الإجراء

الحقول النوع الوصف
followUpToken سلسلة

مطلوبة.

تم تقديم الرمز المميز في طلب EXECUTE الأصلي.

status سلسلة

مطلوبة.

نتيجة الطلب.

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

FAILURE
errorCode سلسلة

مطلوبة.

يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثل 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