설치

처음부터 시작하기

SORI Flutter SDK는 pub.dev의 sorisdk_flutter 패키지로 배포됩니다.

패키지 페이지에서 최신 배포 버전과 생성된 Dart API reference를 확인할 수 있습니다.

pub.dev에서 패키지를 추가합니다.

bash

flutter pub add sorisdk_flutter

또는 pubspec.yaml 파일에 직접 추가합니다.

yaml

dependencies:
  sorisdk_flutter: ^0.1.0

그 다음 패키지를 설치합니다.

bash

flutter pub get

패키지는 필요한 Android 권한과 foreground microphone service 선언을 플러그인 manifest에서 병합합니다. 여기에는 마이크, 네트워크, foreground service, 알림 관련 권한이 포함됩니다.

앱의 Android minSdk는 24 이상이어야 합니다.

kotlin

android {
    defaultConfig {
        minSdk = 24
    }
}

Android에서 startRecognition()은 필요한 경우 런타임 마이크 권한을 요청하고, 권한이 승인되면 동일한 시작 요청을 이어서 실행합니다.

앱이 Android 13 이상을 대상으로 하고 foreground service 알림을 정상적으로 표시해야 한다면, 인식을 시작하기 전에 앱 흐름에서 알림 권한을 요청하세요.

iOS 앱은 ios/Runner/Info.plist에 마이크 사용 설명을 포함해야 합니다.

xml

<key>NSMicrophoneUsageDescription</key>
<string>Audio recognition requires microphone access.</string>

앱이 백그라운드에서도 인식을 계속하도록 설계된 경우에만 background audio mode를 추가하세요.

xml

<key>UIBackgroundModes</key>
<array>
    <string>audio</string>
</array>

이제 SDK를 사용할 준비가 되었습니다. 다음 단계는 구현입니다.