Flutter SDK
SORI Flutter SDK를 사용하면 Android, iOS, Web Flutter 앱에 SORI 기반 오디오 인식, 캠페인 발견, 액션 링크 처리를 추가할 수 있습니다.
사전 요구 사항
- Flutter 3.3.0 이상
- 패키지 제약 조건을 만족하는 Dart SDK
- Android API level 24 이상
- iOS 13.0 이상
- Web의 경우: 보안 컨텍스트(
https://또는http://localhost), Web Audio와getUserMedia()를 지원하는 최신 브라우저, bridge 준비용 Node.js와 npm
Flutter 패키지는 네이티브 SORI Android SDK와 iOS SDK를 감싸고 빌드 타임 bridge를 통해 SORI Web SDK를 연결합니다. Flutter 앱에서 하나의 Dart API로 인식을 시작하고, 캠페인 이벤트를 받고, 지원되는 플랫폼에서 인식 데이터베이스를 업데이트하고, 처리한 액션 URL을 보고할 때 사용합니다.
WARNING
app_id와 secret_key는 모바일 앱을 SORI API Server에 인증하는 값입니다. 실제 값을 저장소, 샘플 앱, 이슈, 스크린샷, 공개 문서에 커밋하지 마세요. Web 앱은 장기 secret을 서버에 보관하고 ephemeral key endpoint를 사용해야 합니다.
가이드
API 참고
Flutter 패키지는 인식 lifecycle 이벤트, 캠페인/결과/오류 이벤트, opt-in 오디오마커 이벤트, 데이터베이스 업데이트, 명시적인 action URL 처리를 제공합니다. 위치, metadata provider, raw audio buffer, 자동 action URL 열기는 public Flutter API에 포함되지 않습니다.
sorisdk_flutter 0.4.0 패키지와 Dart API 레퍼런스를 참고하세요.
예제 앱 참조
SDK를 Flutter 앱에 통합하는 방법을 보여주는 Flutter 예제 앱을 제공합니다.
SORI Flutter 예제v0.4.0
Android 5.1.0과 iOS 5.1.0을 포함합니다. Web SDK 0.6.10과 Web bridge 0.1.5는 변경되지 않았습니다.
- 최신 native SDK를 적용하여 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 감지기를 업데이트하면서 marker opt-in, fingerprint-only 기본 동작 및 기존 Dart API를 유지합니다.
- Flutter Web 사용자는 npm 의존성과 lockfile을 업데이트하고
sori-flutter-web prepare를 실행한 뒤 다시 빌드하고 배포해야 합니다. 이미 배포된 자산은 자동으로 업데이트되지 않습니다.
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 동작은 유지됩니다.
- SDK가 관리하는 현재 오디오마커 상태 및 활동 결과 API를 추가했습니다.
- 유효한 마커 trait으로 인식 결과를 보강하고 마커가 나중에 식별되면 같은 활동을 갱신합니다.
- 현재 상태가 해제되어도 과거 결과의 마커는 유지합니다. 상태 유지는 조건부이며 항상 4초간 표시되는 것은 아닙니다.
- 기존 캠페인 콜백과 시작·중지 연동을 유지하며, 오디오마커 인식은 명시적으로 활성화해야 합니다.
상태·활동 결과 연동과 설치·업데이트 안내를 참고하세요.