طرح صفت کنترل شبکه خانه هوشمند
action.devices.traits.NetworkControl
- این ویژگی متعلق به دستگاه هایی است که از گزارش داده های شبکه و انجام عملیات خاص شبکه پشتیبانی می کنند.
ویژگی های دستگاه
دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت SYNC
، به تحقق هدف مراجعه کنید.
ویژگی های | تایپ کنید | شرح |
---|---|---|
supportsEnablingGuestNetwork | بولی | (پیشفرض: اگر بتوان شبکه مهمان را فعال کرد روی true تنظیم کنید. |
supportsDisablingGuestNetwork | بولی | (پیشفرض: اگر میتوان شبکه مهمان را غیرفعال کرد، روی true تنظیم کنید. |
supportsGettingGuestNetworkPassword | بولی | (پیشفرض: اگر رمز عبور شبکه مهمان را می توان از طریق دستور |
networkProfiles | آرایه | نام پروفایل شبکه پشتیبانی شده را نشان می دهد. |
[ item, ... ] | رشته | نام یک نمایه شبکه که نشان دهنده گروهی از دستگاه های مرتبط است. |
supportsEnablingNetworkProfile | بولی | (پیشفرض: اگر نمایه های شبکه را بتوان فعال کرد، روی true تنظیم کنید. |
supportsDisablingNetworkProfile | بولی | (پیشفرض: اگر نمایه های شبکه را می توان غیرفعال کرد، روی true تنظیم کنید. |
supportsNetworkDownloadSpeedTest | بولی | (پیشفرض: اگر بتوان تست سرعت دانلود را اجرا کرد روی true تنظیم کنید. |
supportsNetworkUploadSpeedTest | بولی | (پیشفرض: اگر بتوان تست سرعت آپلود را اجرا کرد روی 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 | رشته | نشان می دهد که آیا آخرین آزمایش سرعت دانلود شبکه با موفقیت انجام شد یا ناموفق. مقادیر پشتیبانی شده:
|
lastNetworkUploadSpeedTest | هدف - شی | حاوی نتایج آخرین آزمایش سرعت آپلود شبکه است. |
uploadSpeedMbps | عدد | سرعت آپلود بر حسب مگابیت بر ثانیه (مگابیت بر ثانیه) آخرین آزمایش سرعت شبکه. |
unixTimestampSec | عدد صحیح | مهر زمانی یونیکس (تعداد ثانیه از زمان یونیکس) مربوط به آخرین آزمایش سرعت آپلود شبکه. |
status | رشته | نشان می دهد که آیا آخرین آزمایش سرعت آپلود شبکه با موفقیت انجام شد یا ناموفق. مقادیر پشتیبانی شده:
|
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 }
دستگاه دارای نمایه شبکه «کودکان» غیرفعال است.
{ "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 | رشته | ضروری. نام نمایه از ویژگی |
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 | رشته | ضروری. نتیجه درخواست. مقادیر پشتیبانی شده:
|
networkDownloadSpeedMbps | عدد | ضروری. سرعت دانلود شبکه بر حسب مگابیت بر ثانیه اندازه گیری می شود. |
موفقیت: networkUploadSpeedMbps
زمینه های | تایپ کنید | شرح |
---|---|---|
followUpToken | رشته | ضروری. رمز ارائه شده در درخواست اصلی EXECUTE. |
status | رشته | ضروری. نتیجه درخواست. مقادیر پشتیبانی شده:
|
networkUploadSpeedMbps | عدد | ضروری. سرعت آپلود شبکه بر حسب مگابیت بر ثانیه اندازه گیری می شود. |
موفقیت: networkDownloadSpeedMbps و networkUploadSpeedMbps
زمینه های | تایپ کنید | شرح |
---|---|---|
followUpToken | رشته | ضروری. رمز ارائه شده در درخواست اصلی EXECUTE. |
status | رشته | ضروری. نتیجه درخواست. مقادیر پشتیبانی شده:
|
networkDownloadSpeedMbps | عدد | ضروری. سرعت دانلود شبکه بر حسب مگابیت بر ثانیه اندازه گیری می شود. |
networkUploadSpeedMbps | عدد | ضروری. سرعت آپلود شبکه بر حسب مگابیت بر ثانیه اندازه گیری می شود. |
شکست
زمینه های | تایپ کنید | شرح |
---|---|---|
followUpToken | رشته | ضروری. رمز ارائه شده در درخواست اصلی EXECUTE. |
status | رشته | ضروری. نتیجه درخواست. مقادیر پشتیبانی شده:
|
errorCode | رشته | ضروری. مقدار می تواند هر کد خطایی برای این ویژگی باشد، به عنوان مثال، |
مثال ها
سرعت وای فای چقدره؟ (پاسخ بعدی)
{ "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