מצלמה.SwitchWi-Fi

האפליקציה שולחת את הפקודה הזו למצלמה כדי לספק לה פרטי כניסה לצורך גישה לרשת Wi-Fi בתשתית עם גישה לאינטרנט. הפקודה כוללת מפתח סודי K ששותף מראש, שהאפליקציה תשתמש בו בהמשך כדי לאמת את עצמה מול המצלמה, אחרי ששני המכשירים יעברו לתשתית ה-Wi-Fi. הפקודה נוספה ב-API ברמה 2.1, והיא רלוונטית ל-Direct Upload.

פרמטרים

  • preSharedKey: מפתח של 256 ביט שנוצר באופן אקראי, שמשמש לאימות המצלמה עם האפליקציה אחרי ששניהם מחוברים לתשתית ה-Wi-Fi. לדוגמה, ניתן להשתמש ב-RAND_bytes() מ-OpenSSL כדי ליצור את המזהה.
  • SSID של Wi-Fi wifiSsid:.
  • סיסמת Wi-Fi wifiPwd:, אם יש כזו.

תוצאות

  • פקודה זו לא מחזירה תוצאה.

שגיאות

  • missingParameter: חלק מהפרמטר, לדוגמה preSharedKey, חסר.
  • invalidParameterName: אחד או יותר מהשמות של הפרמטרים של הקלט לא מזוהים.
  • invalidParameterValue: השמות של הפרמטרים של הקלט מזוהים, אבל אחד או יותר מהערכים שהועברו לא חוקיים. לדוגמה, wifiPwd מועבר כמספר שלם במקום כמחרוזת.
Command I/O
קלט פקודה 
{
    "parameters": {
        "preSharedKey": "random key",
        "wifiSsid": "home Wi-Fi",
        "wifiPwd": "wifi password"
    }
}
פלט הפקודה 
none
פלט הפקודה (שגיאה) 
{
    "error": {
        "code": "missingParameter",
        "message": "Parameter preSharedKey is missing."
    }
}