طرح صفت کنترل شبکه خانه هوشمند

action.devices.traits.NetworkControl - این ویژگی متعلق به دستگاه هایی است که از گزارش داده های شبکه و انجام عملیات خاص شبکه پشتیبانی می کنند.

ویژگی های دستگاه

دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC ، به تحقق هدف مراجعه کنید.

صفات تایپ کنید توضیحات
supportsEnablingGuestNetwork بولی

(پیش‌فرض: false )

اگر بتوان شبکه مهمان را فعال کرد روی true تنظیم کنید.

supportsDisablingGuestNetwork بولی

(پیش‌فرض: false )

اگر می‌توان شبکه مهمان را غیرفعال کرد، روی true تنظیم کنید.

supportsGettingGuestNetworkPassword بولی

(پیش‌فرض: false )

اگر رمز عبور شبکه مهمان را می توان از طریق دستور GetGuestNetworkPassword به دست آورد، روی true تنظیم کنید.

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

وضعیت دستگاه

موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY ، به تحقق هدف مراجعه کنید.

ایالات تایپ کنید توضیحات
networkEnabled بولی

اینکه آیا شبکه اصلی فعال است یا خیر.

networkSettings شیء

حاوی SSID شبکه اصلی است.

ssid رشته

مورد نیاز.

SSID شبکه

guestNetworkEnabled بولی

اینکه آیا شبکه مهمان فعال است یا خیر.

guestNetworkSettings شیء

حاوی SSID شبکه مهمان است.

ssid رشته

مورد نیاز.

SSID شبکه

numConnectedDevices عدد صحیح

تعداد دستگاه های متصل به شبکه

networkUsageMB شماره

استفاده از شبکه در مگابایت (مگابایت). استفاده از شبکه در دوره صورت‌حساب فعلی است، که می‌تواند برای نظارت بر محدودیت استفاده از شبکه دوره صورت‌حساب مفید باشد.

networkUsageLimitMB شماره

محدودیت استفاده از شبکه در مگابایت (مگابایت). محدودیت استفاده از شبکه در دوره صورتحساب فعلی است.

networkUsageUnlimited بولی

اینکه آیا استفاده از شبکه نامحدود است. وضعیت دستگاه networkUsageLimitMB اگر روی درست تنظیم شود نادیده گرفته می شود.

lastNetworkDownloadSpeedTest شیء

حاوی نتایج آخرین تست سرعت دانلود شبکه است.

downloadSpeedMbps شماره

سرعت دانلود بر حسب مگابیت بر ثانیه (مگابیت بر ثانیه) آخرین تست سرعت شبکه.

unixTimestampSec عدد صحیح

مهر زمانی یونیکس (تعداد ثانیه از زمان یونیکس) مربوط به آخرین آزمایش سرعت دانلود شبکه.

status رشته

نشان می دهد که آیا آخرین آزمایش سرعت دانلود شبکه با موفقیت انجام شد یا ناموفق.

مقادیر پشتیبانی شده:

SUCCESS
FAILURE
lastNetworkUploadSpeedTest شیء

حاوی نتایج آخرین آزمایش سرعت آپلود شبکه است.

uploadSpeedMbps شماره

سرعت آپلود بر حسب مگابیت بر ثانیه (مگابیت بر ثانیه) آخرین آزمایش سرعت شبکه.

unixTimestampSec عدد صحیح

مهر زمانی یونیکس (تعداد ثانیه از زمان یونیکس) مربوط به آخرین آزمایش سرعت آپلود شبکه.

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
}

دستگاه دارای نمایه شبکه «کودکان» غیرفعال است.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "networkProfilesState": {
    "parents": {
      "enabled": true
    },
    "kids": {
      "enabled": false
    }
  }
}

دستورات دستگاه

دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE intent ها، به اجرای Intent مراجعه کنید.

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 رشته

مورد نیاز.

نام نمایه از ویژگی 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 رشته

مورد نیاز.

رمز عبور برای شبکه مهمان.

نمونه ها

گذرواژه Wi-Fi مهمان من را نشان بده. 

{
  "guestNetworkPassword": "123456"
}

action.devices.commands.TestNetworkSpeed

سرعت دانلود و آپلود شبکه را تست کنید.

این دستور به ویژگی های زیر نیاز دارد: 
{
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true
}

پارامترها

پارامترها تایپ کنید توضیحات
testDownloadSpeed بولی

مورد نیاز.

نشان می دهد که آیا سرعت دانلود باید آزمایش شود یا خیر.

testUploadSpeed بولی

مورد نیاز.

نشان می دهد که آیا سرعت آپلود باید آزمایش شود یا خیر.

followUpToken رشته

مورد نیاز.

توکن ارائه شده توسط Google برای پاسخگویی بعدی.

نمونه ها

سرعت وای فای چقدره؟ 

{
  "command": "action.devices.commands.TestNetworkSpeed",
  "params": {
    "testDownloadSpeed": true,
    "testUploadSpeed": true,
    "followUpToken": "123"
  }
}

هنگام تلاش برای درخواست تست سرعت خطایی روی داد.

مقادیر پشتیبانی شده:

networkSpeedTestInProgress

پاسخ های بعدی

دستگاه‌های دارای این ویژگی ممکن است بار پاسخ پیگیری زیر را به عنوان بخشی از عملیات EXECUTE برگردانند. برای کسب اطلاعات بیشتر درباره اجرای پاسخ‌های بعدی، به اطلاعیه‌ها برای اقدامات خانه هوشمند مراجعه کنید.

محموله شامل یکی از موارد زیر است:

موفقیت: NetworkDownloadSpeedMbps

فیلدها تایپ کنید توضیحات
followUpToken رشته

مورد نیاز.

رمز ارائه شده در درخواست اصلی EXECUTE.

status رشته

مورد نیاز.

نتیجه درخواست.

مقادیر پشتیبانی شده:

SUCCESS
networkDownloadSpeedMbps شماره

مورد نیاز.

سرعت دانلود شبکه بر حسب مگابیت بر ثانیه اندازه گیری می شود.

موفقیت: networkUploadSpeedMbps

فیلدها تایپ کنید توضیحات
followUpToken رشته

مورد نیاز.

رمز ارائه شده در درخواست اصلی EXECUTE.

status رشته

مورد نیاز.

نتیجه درخواست.

مقادیر پشتیبانی شده:

SUCCESS
networkUploadSpeedMbps شماره

مورد نیاز.

سرعت آپلود شبکه بر حسب مگابیت بر ثانیه اندازه گیری می شود.

موفقیت: networkDownloadSpeedMbps و networkUploadSpeedMbps

فیلدها تایپ کنید توضیحات
followUpToken رشته

مورد نیاز.

رمز ارائه شده در درخواست اصلی EXECUTE.

status رشته

مورد نیاز.

نتیجه درخواست.

مقادیر پشتیبانی شده:

SUCCESS
networkDownloadSpeedMbps شماره

مورد نیاز.

سرعت دانلود شبکه بر حسب مگابیت بر ثانیه اندازه گیری می شود.

networkUploadSpeedMbps شماره

مورد نیاز.

سرعت آپلود شبکه بر حسب مگابیت بر ثانیه اندازه گیری می شود.

شکست

فیلدها تایپ کنید توضیحات
followUpToken رشته

مورد نیاز.

رمز ارائه شده در درخواست اصلی EXECUTE.

status رشته

مورد نیاز.

نتیجه درخواست.

مقادیر پشتیبانی شده:

FAILURE
errorCode رشته

مورد نیاز.

مقدار می تواند هر کد خطایی برای این ویژگی باشد، به عنوان مثال، transientError .

نمونه ها

سرعت وای فای چقدره؟ (پاسخ بعدی) 

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "networkDownloadSpeedMbps": 23.3,
      "networkUploadSpeedMbps": 10.2,
      "followUpToken": "1234"
    }
  }
}

سرعت وای فای چقدره؟ (پاسخ بعدی با شکست) 

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "transientError",
      "followUpToken": "1234"
    }
  }
}

خطاهای دستگاه

لیست کامل خطاها و استثناها را ببینید.

هنگام تلاش برای کنترل نمایه شبکه داده شده خطایی روی داد.

مقادیر پشتیبانی شده:

networkProfileNotRecognized

هنگام تلاش برای درخواست تست سرعت خطایی روی داد.

مقادیر پشتیبانی شده:

networkSpeedTestInProgress