space_story_sdk 0.0.26 copy "space_story_sdk: ^0.0.26" to clipboard
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 이슈 트래커를 통해 접수해 주세요.