รุ่นที่เผยแพร่

แสดงการเปลี่ยนแปลงจากรุ่นเสถียรที่เผยแพร่ล่าสุด

v5.1.0

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

v5.0.13

• อัปเดตตัวตรวจจับเริ่มต้นสำหรับแอปที่เปิดใช้การรู้จำ Audio Marker โดยยังคงรูปแบบ opt-in และการทำงานแบบ fingerprint-only สำหรับแอปที่ไม่ได้เปิดใช้

v5.0.12

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

v5.0.11

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

v5.0.10

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

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

v5.0.9

• ปรับปรุงประสิทธิภาพการระบุมาร์กเกอร์เสียง

v5.0.7

บันทึกการเปลี่ยนแปลง

การปรับละเอียดกิจกรรมต่อเนื่องตามลำดับ

Android SDK 5.0.7 ถือว่าการตรวจพบสื่อเดียวกันอย่างต่อเนื่องเป็น segment ของกิจกรรม ปัจจุบันหนึ่งรายการตามลำดับ ผลลัพธ์ onCampaignFound ครั้งแรกพร้อมใช้งานทันที และแอปพลิเคชันสามารถอัปเดต timeline ด้วยฟิลด์สาธารณะ campaign.activityId, campaign.materialId และ campaign.trait?.marker ได้ดังนี้

• callback ที่มี marker ในภายหลังและมี campaign.activityId ที่ไม่ว่างตรงกับแถวปัจจุบัน จะปรับละเอียดได้เฉพาะแถวปัจจุบันเท่านั้น อย่าค้นหาทั้งประวัติเพื่อหาแถวมาแทนที่
• การส่งกิจกรรมจะรักษา recognized_at และ position เดิมไว้ ให้คงเวลาหรือตำแหน่ง ของการตรวจพบครั้งแรกที่แอปพลิเคชันแสดง แทนการแทนที่ด้วยเวลาของ callback ที่ปรับละเอียด
• marker แรกที่ยืนยันแล้วและฟิลด์แคมเปญที่ปรับละเอียดแล้วจะคงอยู่ การตรวจไม่พบ marker หรือ callback ซ้ำในภายหลังต้องไม่ลดทอนข้อมูลในแถวนั้น
• เมื่อมี campaign.materialId อื่นคั่นอยู่ segment ก่อนหน้าจะถูกปิด callback ที่ล่าช้า สำหรับ ID กิจกรรมเก่าต้องไม่เขียนทับแถวในประวัติ

v5.0.5

บันทึกการเปลี่ยนแปลง

Android SDK 5.0.5 เปิดเผย ID กิจกรรมของเซิร์ฟเวอร์ใน callback ของแคมเปญทั้งครั้งแรก และหลังปรับละเอียดแล้ว แอปพลิเคชันสามารถใช้ข้อมูลระบุตัวตนนี้เพื่อแทนที่ผล fingerprint แรกด้วยผลที่ปรับละเอียดด้วย Audio Marker โดยไม่ต้องอนุมานข้อมูลระบุตัวตนจาก ID ของ แคมเปญหรือสื่อ callback ของแคมเปญที่มีอยู่และ API สาธารณะของ SDK ยังคงเข้ากันได้

v5.0.3

บันทึกการเปลี่ยนแปลง

การเสริมความแข็งแกร่งให้ AudioPack และการอัปเดต SDK รุ่นเสถียร

รุ่นนี้ยกระดับ Android SDK และแพ็กเกจ Maven เป็นรุ่นเสถียร 5.0.3 พร้อมอัปเดต recognition engine เป็น NADA 0.6.3 และเสริมความแข็งแกร่งให้ การโหลด AudioPack

การปรับปรุง

• เพิ่มงบประมาณการโหลด AudioPack เพื่อปฏิเสธ pack ที่เสียหายหรือมีขนาดใหญ่เกินไป ก่อนที่จะใช้ทรัพยากรมากเกินควร
• ใช้การแทนที่และเพิ่ม AudioPack แบบ transaction เพื่อให้ฐานข้อมูลการรู้จำที่ใช้งานอยู่ ยังคงสมบูรณ์และใช้งานได้เมื่อโหลด pack ไม่สำเร็จ
• ทำให้การเขียน AudioPack ทำงานแบบลำดับเพื่อให้การอัปเดตฐานข้อมูลพร้อมกันปลอดภัยยิ่งขึ้น
• เพิ่มการตรวจสอบว่าค่าการตั้งค่า matcher และ feature extractor ไม่เป็นศูนย์ โดยยังคงค่าเริ่มต้นของ Android SDK
• ยืนยันว่าโมเดลการรู้จำที่รวมมาให้และ AudioPack ของบัญชีที่ถูกต้องยังคงโหลดได้ตามปกติ

หมายเหตุ

ขีดจำกัดของ AudioPack ใช้ค่าเริ่มต้นของ SDK และไม่ได้เปิดเป็นตัวเลือกการตั้งค่า Android แบบสาธารณะ

v5.0.2

บันทึกการเปลี่ยนแปลง

การแก้ไขการแมป segment

รุ่นนี้ปรับปรุงการจับคู่สื่อที่มีหลาย segment และอัปเดต recognition engine ของ Android เป็น NADA 0.6.2

การปรับปรุง

• แก้ไขการเลือก segment เมื่อ metadata ของ segment ตามเวลาต้นทางมีช่วงว่างนำหน้า ที่ถูกตัดออกระหว่างการสกัด fingerprint
• รักษาตำแหน่งและระยะเวลาภายใน segment สำหรับสื่อที่นำมาต่อกัน
• อัปเดต native recognition dependencies เป็น NADA 0.6.2

v5.0.1

บันทึกการเปลี่ยนแปลง

การจับคู่แบบรับรู้ segment และการอัปเดตแพ็กเกจ

รุ่นนี้เพิ่ม match metadata แบบรับรู้ segment และปรับปรุงความเข้ากันได้กับ shrinker สำหรับแอปพลิเคชันที่ใช้ Maven AAR ที่เผยแพร่

การปรับปรุง

• เพิ่มการจัดการตำแหน่งและระยะเวลาภายใน segment สำหรับสื่อที่นำมาต่อกัน
• ส่งต่อ match duration ผ่าน surface AudioDB.MatchResult ที่ใช้ JNI
• รวมกฎ consumer R8 และ ProGuard ที่จำเป็นสำหรับ Parcelize ไว้ใน SDK AAR
• รักษาความเข้ากันได้ของการผสานรวม Maven โดยตรงกับ release minification ปกติ

v5.0.0

บันทึกการเปลี่ยนแปลง

การอัปเดตครั้งใหญ่ของ SDK และ Audio Marker

รุ่นนี้นำเสนอ NADA recognition engine ที่สร้างขึ้นใหม่ และเพิ่มการรู้จำ Audio Marker แบบ opt-in ควบคู่กับขั้นตอน audio fingerprint ที่มีอยู่

การปรับปรุง

• แทนที่ native matcher เดิมด้วย NADA recognition engine ที่ใช้ Rust
• เพิ่มการจับคู่ที่รับรู้ pitch variant และ continuous capture ที่เสถียรยิ่งขึ้นบน Android 10 ขึ้นไป
• เพิ่มการรู้จำ Audio Marker แบบ opt-in ด้วย SORIConfig(audiomarker = true)
• คงพฤติกรรมเริ่มต้นที่ใช้เฉพาะ fingerprint ไว้ เว้นแต่จะเปิดใช้งาน การรู้จำ Audio Marker อย่างชัดเจน
• เพิ่ม callbacks การอัปเดตมาร์กเกอร์ผ่าน onPatternMarkerChanged(marker)
• แนบค่ามาร์กเกอร์ที่ตรวจพบกับผลลัพธ์แคมเปญผ่าน campaign.trait?.marker
• อัปเดตการจัดการ Audio Marker ให้ตรงกับขั้นตอนมาร์กเกอร์ปัจจุบันของ SORI Console
• ปรับปรุงความเสถียรของ recognition stream และการจัดการสถานะมาร์กเกอร์ใน ช่วงการรู้จำซ้ำ
• ลด public native และ JNI symbol surface โดยยังคงพฤติกรรม release build ที่จำเป็น
• ปรับปรุงส่วนภายในของ SDK เพื่อเพิ่มความน่าเชื่อถือ การบำรุงรักษา และความเข้ากันได้กับ platform

หมายเหตุ

แอปพลิเคชันที่ต้องการเฉพาะการรู้จำ fingerprint สามารถใช้ ขั้นตอนการผสานรวมเดิมต่อไปได้ ให้เปิดการรู้จำ Audio Marker เฉพาะเมื่อการตั้งค่า SORI Console ใช้ Audio Markers

v4.3.7

บันทึกการเปลี่ยนแปลง

การอัปเดตความเสถียร

รุ่นนี้ปรับปรุงการจัดการ lifecycle การรู้จำ และทำให้คำขอเริ่มและหยุดซ้ำปลอดภัยยิ่งขึ้นสำหรับแอปพลิเคชัน production

การปรับปรุง

• ปรับปรุงการจัดการคำขอเริ่มและหยุดการรู้จำที่ซ้ำกัน
• เพิ่ม controls ในแอปตัวอย่างเพื่อให้อัปเดตฐานข้อมูลการรู้จำได้ง่ายขึ้น
• ปรับปรุงพฤติกรรม lifecycle ของแอปตัวอย่างเพื่อให้การทดสอบการผสานรวมเชื่อถือได้ยิ่งขึ้น
• ปรับปรุงการจัดการสถานะ SDK เพื่อลดโอกาสเกิดพฤติกรรม runtime ที่ไม่สอดคล้องกัน

v4.3.6

บันทึกการเปลี่ยนแปลง

การอัปเดตความน่าเชื่อถือ

รุ่นนี้เสริมความแข็งแกร่งให้การเริ่มต้น SDK และพฤติกรรมการอัปเดตฐานข้อมูล เพื่อให้ขั้นตอนการเริ่มแอปพลิเคชันและการอัปเดตสอดคล้องกันยิ่งขึ้น

การปรับปรุง

• ปรับปรุงการเริ่มต้น singleton เพื่อให้คาดการณ์การตั้งค่า SDK ได้มากขึ้น
• เพิ่มการคงอยู่ของเวอร์ชันฐานข้อมูลระหว่างขั้นตอนการอัปเดต
• เพิ่มพฤติกรรมการกู้คืนในกรณีที่ไม่สามารถใช้ audio pack ที่รอดำเนินการได้ทันที
• อัปเดต targets ความเข้ากันได้ของ Android platform สำหรับ development environments รุ่นล่าสุด

v4.3.5

บันทึกการเปลี่ยนแปลง

การอัปเดตเพื่อบำรุงรักษา

รุ่นนี้ปรับปรุงพฤติกรรมการรีเซ็ตสถานะ เพื่อป้องกันไม่ให้ข้อมูลการรู้จำที่ล้าสมัยส่งผลกระทบต่อ sessions ในภายหลัง

การปรับปรุง

• ปรับปรุงการจัดการการรีเซ็ตเพื่อให้ล้างสถานะการตรวจจับซ้ำเมื่อรีเซ็ตสถานะ SDK
• เพิ่มความสอดคล้องเมื่อแอปพลิเคชันเริ่มการรู้จำใหม่หลังจากล้างสถานะ
• ลดโอกาสที่ข้อมูล runtime ที่ล้าสมัยจะส่งผลต่อ sessions การรู้จำในภายหลัง

v4.3.4

บันทึกการเปลี่ยนแปลง

การอัปเดตประสิทธิภาพและความเสถียร

รุ่นนี้ปรับปรุงพฤติกรรมการส่ง event และความสอดคล้องของผลลัพธ์แคมเปญภายใต้ workload การรู้จำที่กำลังทำงาน

การปรับปรุง

• ปรับปรุงการจัดการ event เมื่อมีกิจกรรมสูง เพื่อให้ส่งผลลัพธ์ได้ราบรื่นยิ่งขึ้น
• ปรับปรุงการขจัดแคมเปญซ้ำเพื่อให้ผลลัพธ์การรู้จำสอดคล้องยิ่งขึ้น
• ลดโอกาสเกิดการแจ้งเตือนแคมเปญซ้ำซ้อนใน edge cases

v4.3.3

บันทึกการเปลี่ยนแปลง

การอัปเดตความน่าเชื่อถือและประสิทธิภาพ

รุ่นนี้มุ่งเน้นความน่าเชื่อถือของ foreground service ประสิทธิภาพการส่ง event และความเข้ากันได้กับ Android platform

การปรับปรุง

• ปรับปรุงประสิทธิภาพการส่งผลลัพธ์การรู้จำ
• เพิ่มประสิทธิภาพการกู้คืน foreground service เมื่อเริ่มแอปใหม่และเชื่อมต่อใหม่
• ปรับปรุงการคงอยู่ของการแจ้งเตือนสำหรับ sessions การรู้จำที่ทำงานเป็นเวลานาน
• เพิ่มการรองรับประเภท foreground service อย่างชัดเจนสำหรับ Android รุ่นล่าสุด
• เสริมความปลอดภัยของ thread และการจัดการทรัพยากรใน components หลักของ SDK
• ลด campaign events ที่ซ้ำกันในเส้นทางการส่งหลายรูปแบบ
• ปรับปรุงโครงสร้างภายในเพื่อให้บำรุงรักษาง่ายขึ้น

v4.3.2

บันทึกการเปลี่ยนแปลง

การอัปเดตความน่าเชื่อถือของเครือข่าย

รุ่นนี้เพิ่มความทนทานของเครือข่ายสำหรับคำขอการรู้จำและการส่งในพื้นหลัง

การปรับปรุง

• เพิ่มการจัดการเครือข่ายที่กำหนดค่าได้และการรองรับ listener
• ปรับปรุงการจัดคิวคำขอเมื่อการเชื่อมต่อเครือข่ายใช้ไม่ได้
• เพิ่มประสิทธิภาพการจัดการข้อผิดพลาดสำหรับขั้นตอน authentication และดาวน์โหลด audio pack
• ปรับปรุงพฤติกรรมการส่งแบบหน่วงเวลาสำหรับคำขอในคิว
• ปรับปรุงความเข้ากันได้ของการติดตามเครือข่ายใน Android API levels ต่าง ๆ
• เพิ่มการปรับปรุงความเข้ากันได้กับ Android 15 สำหรับ native libraries
• ปรับปรุงการส่ง metadata ในคำขอ API
• เสริมความแข็งแกร่งให้พฤติกรรมการแจ้งเตือนของ foreground service

หมายเหตุ

โปรดอ่านคู่มือการจัดการเครือข่ายหากแอปพลิเคชันต้องใช้พฤติกรรมแบบกำหนดเองเมื่อการเชื่อมต่อใช้ไม่ได้

v4.3.0

บันทึกการเปลี่ยนแปลง

การรองรับการอัปเดตในพื้นหลัง

รุ่นนี้เพิ่มการรองรับการอัปเดตข้อมูลการรู้จำโดยแยกจากขั้นตอนการรู้จำที่กำลังทำงาน

การปรับปรุง

• เพิ่ม method อัปเดตฐานข้อมูลแบบ standalone สำหรับรีเฟรชสื่อ (Material) การรู้จำ
• เพิ่มคำแนะนำการผสานรวม WorkManager สำหรับการอัปเดตในพื้นหลังเป็นระยะ
• ปรับปรุงการจัดการขีดจำกัดเวลาของ foreground service ใน Android 15
• ปรับปรุงพฤติกรรมการอัปเดตเมื่อการรู้จำไม่ได้ทำงานอยู่
• ปรับปรุง preference serialization และการจัดการข้อผิดพลาด
• ปรับปรุงการสร้าง Android build และ documentation artifact

หมายเหตุ

แอปพลิเคชันที่ต้องรีเฟรชข้อมูลการรู้จำโดยอัตโนมัติสามารถใช้คู่มือการอัปเดตฐานข้อมูลในพื้นหลังได้