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

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