camera.switchWi-Fi

應用程式會將這個指令傳送至相機，提供憑證，以便在需要連上網際網路的基礎架構 Wi-Fi 時提供憑證。這個指令包含預先共用密鑰 K，待兩部裝置都切換至基礎架構 Wi-Fi 後，應用程式之後會使用這個金鑰來驗證自己使用相機。這個指令是在 API 級別 2.1 中新增，且與「直接上傳」相關。

參數

  • preSharedKey: 隨機產生的 256 位元金鑰，在兩者都連線至基礎架構 Wi-Fi 後，用於透過應用程式驗證相機。舉例來說，OpenSSL 的 RAND_bytes() 可用來產生這個值。
  • wifiSsid: Wi-Fi SSID。
  • wifiPwd: Wi-Fi 密碼 (如果有的話)。

成果

  • 這個指令不會傳回任何結果。

錯誤

  • missingParameter: 缺少部分參數，例如 preSharedKey。
  • invalidParameterName: 有一或多個輸入參數名稱無法辨識。
  • 系統可辨識 invalidParameterValue: 輸入參數名稱，但一或多個傳遞的值無效。例如，wifiPwd 會以整數 (而非字串) 的形式傳入。
指令 I/O
指令輸入 
{
    "parameters": {
        "preSharedKey": "random key",
        "wifiSsid": "home Wi-Fi",
        "wifiPwd": "wifi password"
    }
}
指令輸出 
none
指令輸出 (錯誤) 
{
    "error": {
        "code": "missingParameter",
        "message": "Parameter preSharedKey is missing."
    }
}