릴리즈

최근 안정 릴리즈의 변경사항을 표시합니다.

v5.1.0

• 인식을 중단하지 않고 대상 소재를 업데이트할 수 있어 업데이트 중 안정성과 연속성이 향상되었습니다.

v5.0.13

• Audio Marker 인식을 활성화한 앱의 기본 감지기를 업데이트했습니다. opt-in 방식과 활성화하지 않은 앱의 fingerprint-only 동작은 그대로 유지됩니다.

v5.0.12

• 연속 인식 중 캠페인 식별을 개선했습니다.

v5.0.11

• 연속 인식 중 배터리 효율을 개선했습니다.
• 인식 안정성을 개선했습니다.

v5.0.10

• SDK가 관리하는 현재 오디오마커 상태 및 활동 결과 API를 추가했습니다.
• 유효한 마커 trait으로 인식 결과를 보강하고 마커가 나중에 식별되면 같은 활동을 갱신합니다.
• 현재 상태가 해제되어도 과거 결과의 마커는 유지합니다. 상태 유지는 조건부이며 항상 4초간 표시되는 것은 아닙니다.
• 기존 캠페인 콜백과 시작·중지 연동을 유지하며, 오디오마커 인식은 명시적으로 활성화해야 합니다.

상태·활동 결과 연동과 설치·업데이트 안내를 참고하세요.

v5.0.9

• 오디오 마커 식별 성능을 개선했습니다.

v5.0.7

Changelog

순서 기반 연속 활동 정제

Android SDK 5.0.7은 동일한 소재의 연속 관측을 순서가 있는 하나의 현재 활동 세그먼트로 처리합니다. 최초 onCampaignFound 결과는 즉시 사용할 수 있으며, 애플리케이션은 공개 필드인 campaign.activityId, campaign.materialId, campaign.trait?.marker를 사용하여 타임라인을 업데이트할 수 있습니다.

• 비어 있지 않은 campaign.activityId가 현재 행과 같은 후속 marker 포함 콜백은 현재 행만 정제할 수 있습니다. 교체할 행을 찾기 위해 전체 이력을 검색하지 마세요.
• 활동 전송의 원래 recognized_at과 position은 유지됩니다. 애플리케이션에 표시한 최초 관측 시각이나 위치를 후속 정제 콜백 시각으로 교체하지 마세요.
• 최초로 확인된 marker와 정제된 캠페인 필드는 고정됩니다. 이후의 marker miss 또는 중복 콜백이 해당 행을 이전 상태로 되돌리면 안 됩니다.
• 다른 campaign.materialId가 중간에 관측되면 이전 세그먼트가 닫힙니다. 이전 활동 ID의 지연된 콜백이 과거 행을 다시 작성하면 안 됩니다.

v5.0.5

Changelog

Android SDK 5.0.5는 이제 최초 및 정제된 캠페인 콜백에서 서버 활동 ID를 노출합니다. 애플리케이션은 캠페인 또는 소재 ID에서 식별자를 유추하지 않고 이 ID를 사용하여 최초 핑거프린트 결과를 오디오 마커로 정제된 결과로 교체할 수 있습니다. 기존 캠페인 콜백과 공개 SDK API는 계속 호환됩니다.

v5.0.3

Changelog

AudioPack 강화 및 안정 SDK 업데이트

이번 릴리즈는 Android SDK와 Maven 패키지를 안정 버전 5.0.3으로 승격하고, 인식 엔진을 NADA 0.6.3으로 업데이트하여 AudioPack 로딩을 강화합니다.

Improvements

• 손상되었거나 지나치게 큰 pack이 과도한 리소스를 사용하기 전에 거부되도록 AudioPack 로딩 예산을 추가했습니다.
• AudioPack 교체 및 추가를 트랜잭션으로 적용하여 pack 로딩에 실패해도 활성 인식 데이터베이스가 온전하고 사용 가능한 상태로 유지됩니다.
• AudioPack writer 작업을 직렬화하여 동시 데이터베이스 업데이트를 더 안전하게 처리합니다.
• Android SDK 기본값을 유지하면서 matcher 및 feature extractor 설정값이 0이 아닌지 검증하도록 했습니다.
• 번들 인식 모델과 유효한 계정 AudioPack이 계속 정상적으로 로드되는지 확인했습니다.

Notes

AudioPack 제한은 SDK 기본값을 사용하며 공개 Android 설정 옵션으로 노출되지 않습니다.

v5.0.2

Changelog

세그먼트 매핑 수정

이번 릴리즈는 다중 세그먼트 소재의 매칭을 개선하고 Android 인식 엔진을 NADA 0.6.2로 업데이트합니다.

Improvements

• 소스 시간 기준 segment metadata에 핑거프린트 추출 중 제거되는 선행 gap이 포함된 경우의 세그먼트 선택을 수정했습니다.
• 연결된 소재에서 세그먼트 내부의 match position과 duration을 유지합니다.
• native 인식 의존성을 NADA 0.6.2로 업데이트했습니다.

v5.0.1

Changelog

세그먼트 인식 매칭 및 패키징 업데이트

이번 릴리즈는 세그먼트 인식 match metadata를 추가하고 공개 Maven AAR을 사용하는 애플리케이션의 shrinker 호환성을 개선합니다.

Improvements

• 연결된 소재에서 세그먼트 내부 position과 duration을 처리하도록 했습니다.
• JNI-backed AudioDB.MatchResult surface를 통해 match duration을 전달합니다.
• Parcelize에 필요한 consumer R8 및 ProGuard 규칙을 SDK AAR에 포함했습니다.
• 일반 release minification을 사용하는 Maven 직접 통합과의 호환성을 유지합니다.

v5.0.0

Changelog

주요 SDK 및 오디오마커 업데이트

이번 릴리즈는 재구성된 NADA 인식 엔진을 도입하고, 기존 오디오 핑거프린트 흐름과 함께 명시적으로 켤 수 있는 오디오마커 인식을 추가합니다.

Improvements

• 기존 native matcher를 Rust 기반 NADA 인식 엔진으로 교체했습니다.
• pitch variant 인식 매칭과 Android 10 이상에서 더 안정적인 continuous capture를 추가했습니다.
• SORIConfig(audiomarker = true)로 켜는 오디오마커 인식을 추가했습니다.
• 오디오마커 인식을 명시적으로 활성화하지 않으면 기본 fingerprint-only 동작을 유지합니다.
• onPatternMarkerChanged(marker)를 통해 marker update callback을 받을 수 있습니다.
• 감지된 marker value를 campaign.trait?.marker를 통해 캠페인 결과에 첨부합니다.
• 현재 SORI Console 오디오마커 workflow에 맞게 marker handling을 업데이트했습니다.
• 반복되는 인식 window 전반의 recognition stream 안정성과 marker state 처리를 개선했습니다.
• 필요한 release build 동작을 유지하면서 공개 native 및 JNI symbol surface를 축소했습니다.
• 신뢰성, 유지보수성, 플랫폼 호환성을 높이도록 SDK 내부를 개선했습니다.

Notes

오디오 핑거프린트 인식만 필요한 애플리케이션은 기존 통합 흐름을 그대로 사용할 수 있습니다. SORI Console 설정에서 오디오마커를 사용하는 경우에만 오디오마커 인식을 활성화하세요.

v4.3.7

Changelog

Stability Update

이번 릴리즈는 인식 lifecycle 처리를 개선하고, 반복적인 시작 및 중지 요청을 프로덕션 애플리케이션에서 더 안전하게 처리합니다.

Improvements

• 중복된 인식 시작 및 중지 요청 처리를 개선했습니다.
• 샘플 앱에서 인식 데이터베이스를 더 쉽게 업데이트할 수 있는 제어 기능을 추가했습니다.
• 더 안정적인 통합 테스트를 위해 샘플 앱 lifecycle 동작을 개선했습니다.
• 일관되지 않은 런타임 동작 가능성을 줄이도록 SDK 상태 처리를 개선했습니다.

v4.3.6

Changelog

Reliability Update

이번 릴리즈는 더 일관된 앱 시작 및 업데이트 흐름을 위해 SDK 초기화와 데이터베이스 업데이트 동작을 강화합니다.

Improvements

• 더 예측 가능한 SDK 설정을 위해 singleton 초기화를 개선했습니다.
• 업데이트 흐름에서 데이터베이스 버전 저장 동작을 강화했습니다.
• 대기 중인 audio pack 적용을 즉시 완료할 수 없는 경우를 위한 복구 동작을 추가했습니다.
• 최신 개발 환경에 맞춰 Android 플랫폼 호환성 target을 업데이트했습니다.

v4.3.5

Changelog

Maintenance Update

이번 릴리즈는 오래된 인식 데이터가 이후 세션에 영향을 주지 않도록 상태 reset 동작을 개선합니다.

Improvements

• SDK 상태가 reset될 때 중복 감지 상태도 함께 정리되도록 reset 처리를 개선했습니다.
• 상태 정리 후 애플리케이션이 인식을 다시 시작할 때의 일관성을 개선했습니다.
• 오래된 런타임 데이터가 이후 인식 세션에 영향을 줄 가능성을 줄였습니다.

v4.3.4

Changelog

Performance and Stability Update

이번 릴리즈는 활발한 인식 작업 중 이벤트 전달 동작과 캠페인 결과 일관성을 개선합니다.

Improvements

• 액티비티가 많은 상황에서도 더 원활하게 결과를 전달하도록 이벤트 처리를 개선했습니다.
• 더 일관된 인식 결과를 위해 캠페인 중복 제거를 개선했습니다.
• 일부 edge case에서 중복 캠페인 알림이 발생할 가능성을 줄였습니다.

v4.3.3

Changelog

Reliability and Performance Update

이번 릴리즈는 foreground service 신뢰성, 이벤트 전달 성능, Android 플랫폼 호환성에 중점을 둡니다.

Improvements

• 인식 결과 전달 성능을 개선했습니다.
• 앱 재시작 및 재연결 상황에서 foreground service 복구 동작을 강화했습니다.
• 장시간 실행되는 인식 세션의 알림 유지 동작을 개선했습니다.
• 최신 Android 버전을 위한 명시적 foreground service type 지원을 추가했습니다.
• 핵심 SDK 컴포넌트 전반의 thread-safety와 리소스 관리를 강화했습니다.
• 여러 전달 경로에서 중복 캠페인 이벤트가 발생할 가능성을 줄였습니다.
• 유지보수성을 높이기 위해 내부 구조를 정리했습니다.

v4.3.2

Changelog

Network Reliability Update

이번 릴리즈는 인식 요청과 백그라운드 전달에 대한 네트워크 복원력을 강화합니다.

Improvements

• 설정 가능한 네트워크 처리와 listener 지원을 추가했습니다.
• 네트워크 연결을 사용할 수 없을 때 request queuing 동작을 개선했습니다.
• 인증 및 audio pack 다운로드 흐름의 오류 처리를 강화했습니다.
• 대기 중인 요청의 delayed sending 동작을 개선했습니다.
• Android API 레벨 전반의 네트워크 모니터링 호환성을 개선했습니다.
• native library를 위한 Android 15 호환성 개선을 추가했습니다.
• API 요청의 metadata 전달을 개선했습니다.
• foreground service 알림 동작을 강화했습니다.

Notes

네트워크 연결을 사용할 수 없는 상황에서 사용자 지정 동작이 필요한 애플리케이션은 network handling 가이드를 확인하세요.

v4.3.0

Changelog

Background Update Support

이번 릴리즈는 활성 인식 흐름과 독립적으로 인식 데이터를 업데이트할 수 있는 기능을 추가합니다.

Improvements

• 인식 자료를 새로 고치기 위한 standalone database update method를 추가했습니다.
• 주기적인 background update를 위한 WorkManager 통합 가이드를 추가했습니다.
• Android 15 foreground service time-limit 처리를 개선했습니다.
• 인식이 실행 중이 아닐 때의 update 동작을 개선했습니다.
• preference serialization과 오류 처리를 개선했습니다.
• Android build 및 documentation artifact 생성을 개선했습니다.

Notes

인식 데이터를 자동으로 갱신해야 하는 애플리케이션은 background database update 가이드를 사용할 수 있습니다.