Flutter SDK

SORI Flutter SDK ช่วยให้คุณเพิ่มการรู้จำเสียงด้วย SORI การค้นหาแคมเปญ และการจัดการ action link ให้กับแอป Flutter บน Android, iOS และ Web

ข้อกำหนดเบื้องต้น

• Flutter 3.3.0 ขึ้นไป
• Dart SDK ที่เข้ากันได้กับข้อกำหนดเวอร์ชันของแพ็กเกจ
• Android API level 24 ขึ้นไป
• iOS 13.0 ขึ้นไป
• สำหรับ Web: secure context (https:// หรือ http://localhost), เบราว์เซอร์สมัยใหม่ที่รองรับ Web Audio และ getUserMedia() รวมถึง Node.js พร้อม npm สำหรับเตรียม bridge

แพ็กเกจ Flutter ห่อหุ้ม native SORI Android และ iOS SDKs และเชื่อม SORI Web SDK ผ่าน build-time bridge ใช้แพ็กเกจนี้เมื่อแอปสร้างด้วย Flutter และคุณต้องการ Dart API เดียวสำหรับเริ่มการรู้จำ รับ campaign events อัปเดตฐานข้อมูลการรู้จำบนแพลตฟอร์มที่รองรับ และรายงาน action URLs ที่จัดการแล้ว

WARNING

app_id และ secret_key ใช้ยืนยันตัวตนของแอปมือถือกับ SORI API Server ห้าม commit ค่าจริงลงใน repository แอปตัวอย่าง issue ภาพหน้าจอ หรือเอกสารสาธารณะ แอป Web ต้องเก็บ secret ที่มีอายุยาวนานไว้บนเซิร์ฟเวอร์และใช้ endpoint สำหรับ ephemeral key

คู่มือ

• การติดตั้ง
• การนำไปใช้

หมายเหตุเกี่ยวกับ API

แพ็กเกจ Flutter เปิดให้ใช้งาน recognition lifecycle events, campaign/result/error events, Audio Marker events แบบ opt-in, การอัปเดตฐานข้อมูล และการจัดการ action URL อย่างชัดเจน ส่วน location, metadata provider, raw audio buffers และการเปิด action URL โดยอัตโนมัติไม่รวมอยู่ใน Flutter API สาธารณะ

ดูแพ็กเกจ sorisdk_flutter 0.4.0 และเอกสารอ้างอิง Dart API

แอปตัวอย่าง

เรามีแอป Flutter ตัวอย่างที่แสดงวิธีผสานรวม SDK

SORI Example Flutter

v0.4.0

รวม Android 5.1.0 และ iOS 5.1.0 ส่วน Web SDK 0.6.10 และ Web bridge 0.1.5 ไม่มีการเปลี่ยนแปลง

• ใช้ SDK แบบ native รุ่นล่าสุด เพื่อให้อัปเดตสื่อเป้าหมายบน Android และ iOS ได้โดยไม่ขัดจังหวะการรู้จำ พร้อมเพิ่มความเสถียรและความต่อเนื่องระหว่างการอัปเดต

v0.3.8

รวม Android 5.0.13, iOS 5.0.12, Web SDK 0.6.10 และ Web bridge 0.1.5

• อัปเดตตัวตรวจจับ Audio Marker เริ่มต้นในทุกแพลตฟอร์ม โดยยังคงการเปิดใช้แบบ opt-in ค่าเริ่มต้นแบบ fingerprint-only และ Dart API เดิม
• ผู้ใช้ Flutter Web ต้องอัปเดต npm dependency และ lockfile รัน sori-flutter-web prepare จากนั้น build และ deploy ใหม่ asset ที่ deploy แล้วจะไม่อัปเดตโดยอัตโนมัติ

v0.3.7

รวม Android 5.0.12 และ iOS 5.0.11

• ปรับปรุงการระบุแคมเปญระหว่างการรู้จำแบบต่อเนื่องบน Android และ iOS

v0.3.6

รวม Android 5.0.11 และ iOS 5.0.10

• ปรับปรุงประสิทธิภาพการใช้แบตเตอรี่ระหว่างการรู้จำแบบต่อเนื่องบน Android
• ปรับปรุงความเสถียรของการรู้จำบน Android, iOS และ Web

v0.3.5

รวม Android 5.0.10 และ iOS 5.0.9 วงจรสถานะมาร์กเกอร์ใหม่ใช้กับแพลตฟอร์มมือถือเหล่านี้ โดยพฤติกรรม Web ไม่เปลี่ยนแปลง

• เพิ่ม API สถานะ Audio Marker ปัจจุบันและผลลัพธ์กิจกรรมที่ SDK จัดการ
• เสริมผลลัพธ์การรู้จำด้วย trait ของมาร์กเกอร์ที่ยังมีผล และอัปเดตกิจกรรมเดิมเมื่อระบุตัวตนมาร์กเกอร์ได้ภายหลัง
• เก็บมาร์กเกอร์ในผลลัพธ์ย้อนหลังไว้แม้สถานะปัจจุบันถูกล้าง การเก็บสถานะขึ้นอยู่กับเงื่อนไข ไม่ได้รับประกันว่าจะแสดงครบสี่วินาที
• คง callback แคมเปญและการเชื่อมต่อเริ่มและหยุดเดิม การรู้จำ Audio Marker ยังต้องเปิดใช้งานโดยชัดแจ้ง

ดู การเชื่อมต่อสถานะและผลลัพธ์กิจกรรม และ คำแนะนำการติดตั้งและอัปเดต