มีอะไรใหม่

API ระดับ 2.1

เปิดตัวพฤษภาคม 2017

การเปลี่ยนแปลงที่สำคัญ

API ระดับ 2

เผยแพร่เมื่อเดือนกรกฎาคม 2016

การเปลี่ยนแปลงที่สำคัญ

  • เลิกใช้งาน sessionId และคำสั่งที่เกี่ยวข้องที่เลิกใช้งานแล้ว/แก้ไข API ระดับ 2 ออกแบบมาเพื่อการเชื่อมต่อไคลเอ็นต์ 1 เครื่อง และผู้ผลิตกล้องควรตรวจสอบว่ามีการเชื่อมต่อกับไคลเอ็นต์เพียง 1 รายการทุกครั้ง (เช่น ผ่านการจำกัดการเชื่อมต่อ Wi-Fi เพียง 1 รายการ)
  • คำสั่งที่เลิกใช้งาน getImage / getMetadata
    • URL ที่สมบูรณ์ของไฟล์จะใช้เพื่อดาวน์โหลดโดยตรงจากเซิร์ฟเวอร์ HTTP ของกล้อง
  • คำสั่งที่เพิ่ม/แก้ไขและตัวเลือกสำหรับการจับภาพวิดีโอ การจับภาพตามช่วงเวลา และการแสดงตัวอย่างแบบสด
    • คำสั่งที่เพิ่ม startCapture / stopCapture / getLivePreview / processPicture / reset
    • เปลี่ยนชื่อ listImages เป็น listFiles และอินพุต/เอาต์พุตที่แก้ไขเพื่อจัดการประเภทวิดีโอและประเภทรูปภาพ
    • เพิ่มตัวเลือก previewFormat, previewFormatSupport, captureInterval, captureIntervalSupport, captureNumber, captureNumberSupport, remainingVideoSeconds, pollingDelay, delayProcessing, delayProcessingSupport และ clientVersion
    • ตัวเลือกที่แก้ไขแล้ว captureModeSupport, isoSupport, shutterSpeedSupport, fileFormatSupport, hdr, hdrSupport, exposureBracket และ exposureBracketSupport
  • เพิ่มข้อกำหนดวิดีโอ 360 XMP
  • เพิ่มช่อง apiLevel ลงในเอาต์พุต /osc/info แล้ว
    • apiLevel: เพิ่มฟิลด์ใน API ระดับ 2 แล้ว ระบบจะถือว่าเป็น API ระดับ 1 โดยค่าเริ่มต้น เมื่อไม่มีช่องนี้ นักพัฒนาแอปมีหน้าที่รับผิดชอบในการดึงข้อมูลนี้และใช้งานที่แตกต่างออกไปตามค่า

ความเข้ากันได้แบบย้อนหลัง

  • ผู้ผลิตกล้อง: หากคุณเคยรองรับ API ระดับ 1 ขอแนะนำเป็นอย่างยิ่งให้รองรับทั้ง API ระดับ 1 และ API ระดับ 2 เป็นโซลูชันระดับกลางเป็นเวลา 2-3 เดือนก่อนการอัปเดตครั้งสุดท้าย และทำการอัปเดตเฟิร์มแวร์สำหรับกล้องที่ใช้ API ระดับ 1 มิฉะนั้นไคลเอ็นต์ที่รองรับ API ระดับ 1 เท่านั้นจะทำงานร่วมกับกล้องไม่ได้
  • นักพัฒนาแอป: โปรดทราบว่าการเปลี่ยนแปลงเหล่านี้ส่งผลต่อแอปที่เผยแพร่ก่อนหน้านี้ของคุณ และเป็นความรับผิดชอบของคุณที่จะต้องทำการเปลี่ยนแปลงให้สอดคล้องกันเพื่อจัดการทั้ง 2 เวอร์ชันและเตือนให้เจ้าของกล้องอัปเดตเฟิร์มแวร์