camera.switchWifi

ويرسل التطبيق هذا الأمر إلى الكاميرا لتزويدها ببيانات اعتماد الوصول إلى شبكة Wi-Fi في البنية الأساسية تتيح الوصول إلى الإنترنت. يتضمن الأمر مفتاحًا سريًا تمت مشاركته مسبقًا K والذي سيستخدمه التطبيق لاحقًا لمصادقة نفسه باستخدام الكاميرا بعد تبديل الجهازين إلى شبكة Wi-Fi للبنية الأساسية. تمّت إضافة هذا الأمر في المستوى 2.1 من واجهة برمجة التطبيقات وهو مناسب للتحميل المباشر.

المَعلمات

  • preSharedKey: مفتاح بقيمة 256 بت يتم إنشاؤه عشوائيًا ويُستخدم لمصادقة الكاميرا باستخدام التطبيق بعد اتصالهما بشبكة Wi-Fi في البنية الأساسية. على سبيل المثال، يمكن استخدام RAND_bytes() من OpenSSL لإنشاء هذا.
  • معرّف SSID لشبكة Wi-Fi في wifiSsid:.
  • wifiPwd: كلمة مرور Wi-Fi، إن توفّرت

النتائج

  • لا يعرض هذا الأمر أي نتيجة.

الأخطاء

  • 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."
    }
}