應用程式會將這個指令傳送至相機,提供憑證,以便在需要連上網際網路的基礎架構 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 | |
---|---|
指令輸入 | { |
指令輸出 | none |
指令輸出 (錯誤) | { |