space_story_sdk 0.0.26
space_story_sdk: ^0.0.26 copied to clipboard
A Flutter plugin for AR functionality using ARKit on iOS.
Space Story SDK #
개요 #
Space Story SDK는 AR 및 다양한 미션 기능을 제공하는 Flutter 플러그인입니다. 현재 iOS 플랫폼을 지원합니다.
기능 #
1. 걸음수 추적 (Pedometer) #
특징
- 실시간 걸음수 추적
- 목표 걸음수 설정 가능
- 권한 자동 관리
- 미션 완료 상태 확인
사용 방법
import 'package:space_story_sdk/space_story_sdk.dart';
// 걸음수 미션 시작
SpaceStorySdk.pedometerProvider.startStepMission(1000); // 1000걸음 목표
// 현재 상태 확인
int currentSteps = SpaceStorySdk.pedometerProvider.state.totalSteps;
bool isCompleted = SpaceStorySdk.pedometerProvider.state.isCompleted;
// 미션 중지
SpaceStorySdk.pedometerProvider.stopStepMission();
주의사항
- 권한: 활동 인식(Activity Recognition) 권한 필요
- 플랫폼: iOS, Android 지원
- 배터리 소모에 유의
2. 카메라 미션 #
특징
- 간편한 카메라 미션 시작
- 이미지 캡처 및 기본 검증
- 미션 완료 콜백 제공
사용 방법
import 'package:space_story_sdk/space_story_sdk.dart';
// 카메라 미션 화면 표시
Widget cameraMission = SpaceStorySdk.cameraMissionView(
onMissionComplete: (bool isSuccess) {
if (isSuccess) {
print('카메라 미션 성공!');
} else {
print('카메라 미션 실패');
}
},
);
// 앱에 카메라 미션 화면 추가
Navigator.push(
context,
MaterialPageRoute(builder: (context) => cameraMission)
);
주의사항
- 권한: 카메라 권한 필요
- 플랫폼: iOS, Android 지원
- 이미지 검증 로직은 기본 구현 제공
권한 설정 #
iOS (Info.plist) #
<key>NSCameraUsageDescription</key>
<string>카메라 미션을 위해 카메라 접근이 필요합니다.</string>
<key>NSMotionUsageDescription</key>
<string>걸음수 추적을 위해 활동 인식 권한이 필요합니다.</string>
Android (AndroidManifest.xml) #
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION"/>
설치 #
pubspec.yaml
에 다음을 추가:
dependencies:
space_story_sdk: ^0.0.10
지원 버전 #
- Flutter: >=3.3.0
- Dart: >=3.0.0 <4.0.0
- iOS: 최신 버전
- Android: 최신 버전
라이선스 #
Apache 2.0
문의 #
문의 사항은 GitHub 이슈 트래커를 통해 접수해 주세요.