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에 포함되지 않습니다.
패키지 metadata와 생성된 Dart API reference는 pub.dev의 sorisdk_flutter를 참고하세요.
예제 앱 참조
SDK를 Flutter 앱에 통합하는 방법을 보여주는 Flutter 예제 앱을 제공합니다.
SORI Flutter 예제