iOS SDK

학습된 Roboflow 모델을 iOS 앱에 배포하세요

Roboflow Mobile iOS SDK는 모델을 엣지(iPad 또는 iPhone)에서 실행해야 더 빠른 추론을 하거나 증강 현실과 같은 새로운 기능, 역량 및 사용 사례를 열어야 하는 iOS 애플리케이션을 개발할 때 훌륭한 선택입니다.

맞춤형 컴퓨터 비전 모델이 내장된 네이티브 모바일 애플리케이션은 개발자가 앱에 시각 기능을 제공할 수 있게 합니다.

지원 작업

호스팅된 API에서 다음 작업 유형을 지원합니다:

작업 유형	iOS SDK 배포에서 지원됨
객체 감지	✅
분류
인스턴스 분할	✅ (iOS 18 이상)
시맨틱 분할

모델을 iOS 기기에 배포하기

지원되는 하드웨어 및 소프트웨어

모든 iOS 기기는 기기 내 추론을 지원하지만 iPhone 8(A11 Bionic 프로세서)보다 오래된 기기는 에너지 효율이 낮은 GPU 엔진으로 대체됩니다.

Roboflow는 최소 iOS 버전 15.4(인스턴스 분할 모델의 경우 18.0)를 요구합니다.

프로토타이핑

다음에 대해 개발할 수 있습니다 Roboflow Hosted Inference API입니다. 이는 기기 내 추론에서 사용하는 것과 동일한 학습된 모델을 사용합니다.

설치

• 설치 CocoaPods | 문제 해결 안내

"CocoaPods는 Ruby로 작성되었으며 macOS에 기본으로 포함된 Ruby로 설치할 수 있습니다. Ruby 버전 관리자를 사용할 수 있지만, 무엇을 하는지 잘 모른다면 macOS에 기본으로 제공되는 표준 Ruby를 사용하는 것을 권장합니다. 기본 Ruby 설치를 사용할 경우 gem을 설치할 때 sudo 를 사용해야 합니다. (이는 gem 설치 기간에만 해당되는 문제입니다.)" - CocoaPods

RubyGems에 관리자 권한을 부여하고 싶지 않을 경우 "Sudo-less" 설치 옵션이 있습니다. 다만, sudo 설치 방식이 더 일반적입니다.

CocoaPods가 성공적으로 설치되었는지 확인하려면 다음을 입력하세요 pod --version 터미널에 입력하세요.

Roboflow CocoaPod 설치하기

먼저 다음을 실행하세요 pod init 프로젝트 디렉터리에서.

다음 항목이 있는지 확인하세요 Podfile 다음 플랫폼을 지정합니다 platform :ios, '15.4'

다음으로, 추가하세요 pod 'Roboflow' 다음에 Podfile.

XCode 명령줄 도구가 설치되어 있지 않다면 다음을 실행하세요 xcode-select --install 터미널에 입력하세요.

다음과 같은 결과를 반환합니다: xcode-select: error: command line tools are alreadyinstalled, use "Software Update" to install updates 시스템에 명령줄 도구가 이미 있는 경우.

마지막으로, 다음을 실행하세요 pod install 그리고 생성된 .xcworkspace 파일을 XCode.

에서 열어보세요 (Podfile의 성공적인 설치 후 터미널)

Podfile이 성공적으로 설치된 후의 프로젝트 디렉터리

• 만약 "You may have encountered a bug in the Ruby interpreter or extension libraries"라는 오류가 반환된다면, 먼저 다음을 실행하세요 brew install cocoapods그런 다음 다음을 실행하세요 pod install 그리고 생성된 .xcworkspace XCode에서 파일을.

  • CocoaPods가 성공적으로 설치되었는지 확인하려면 다음을 입력하세요 pod --version 터미널에 입력하세요.

Swift에서 Roboflow 사용하기

다음 위치로 이동하세요 .xcworkspace XCode에서 파일을.

다음으로, Roboflow를 가져오려면 다음을 추가하세요 import Roboflow파일에. .xcworkspace 파일.

그런 다음 Roboflow API 인스턴스를 생성하세요 let rf = Roboflow(apiKey: "API_KEY")입니다. modelVersion에서, 다음을 교체하세요 YOUR-MODEL-VERSION-# 를 모델 버전 번호의 정수 값으로 바꾸세요.

프로젝트 정보 찾기

완료 핸들러 사용법:

import Roboflow
...
//API 키로 초기화
let rf = RoboflowMobile(apiKey: "API_KEY")
var model: RFModel?
...

//model은 모델의 프로젝트 이름입니다
rf.load(model: "YOUR-MODEL-ID", modelVersion: YOUR-MODEL-VERSION-#) { [self] model, error, modelName, modelType in
    if error != nil {
        print(error?.localizedDescription as Any)
    } else {
        model?.configure(threshold: threshold, overlap: overlap, maxObjects: maxObjects
                            processingMode: .performance or .balanced or .quality, // instance seg
                            maxNumberPoints: max number of mask processing points) // instance seg
        self.model = model
    }
    
}
...

//model?.detect는 UIImage를 받아 추론을 수행합니다
let img = UIImage(named: "example.jpeg") // 또는 CVPixelBuffer
model?.detect(image: img!) { predictions, error in
    if error != nil {
        print(error)
    } else {
        print(predictions)
    }
}

비동기 사용:

비동기적으로 사용하려면 Roboflow 모델을 비동기 블록 내에서 호출해야 합니다.

import Roboflow
...
//API 키로 초기화
let rf = RoboflowMobile(apiKey: "API_KEY")
...

//model은 모델의 프로젝트 이름입니다
let (model, loadingError, modelName, modelType) = await rf.load(model: "YOUR-MODEL-ID", modelVersion: YOUR-MODEL-VERSION-#)
model!.configure(threshold: threshold, overlap: overlap, maxObjects: maxObjects)
...

//model?.detect는 UIImage를 받아 추론을 수행합니다
let img = UIImage(named: "example.jpeg")
let (predictions, predictionError) = await model!.detect(image: img!)
print(predictions)

예측 형식:

x:Float // 객체 중심 x
y:Float // 객체 중심 y
width:Float
height:Float
className:String
confidence:Float
color:UIColor
box:CGRect
points:[CGPoint] // 인스턴스 분할 모델 전용

CGRect

네이티브 Swift 예제

The roboflow-ios-starter 앱은 roboflow 모델로 실시간 iOS 앱을 만드는 데 훌륭한 시작점입니다. 여기에는 카메라 설정, 모델 로드 및 처리, 객체 감지 및 인스턴스 분할 모델 모두에 대한 출력 그리기 코드가 포함되어 있습니다.

React Native Expo 앱 예제

이 SDK를 Expo 앱에 React Native로 통합하는 예제도 제공합니다. 자체 하위 애플리케이션을 구성할 때 유용할 수 있습니다.

다음 항목이 둘 다 있는지 확인하세요 Expo 및 CocoaPods 설치되어 있습니다.

• expo-cli 다음 Node.js 버전을 지원합니다: >=12.13.0 <15.0.0 (Maintenance LTS) 및 >=16.0.0 <17.0.0 (Active LTS)

• yarn 패키지는 Node.js에 설치되어 있어야 합니다 (npm install -g yarn)

GitHub - roboflow/RoboflowExpoExampleGitHub

예제 iOS 애플리케이션 - CashCounter

다운로드 CashCounter, 미국 동전과 지폐를 세는 예제 iOS 앱으로 iPhone에 컴퓨터 비전 모델을 배포하는 방법의 예시입니다. 경계 상자 시각화, FPS, 객체 카운팅, 이미지 업로드 등 여러 예제를 확인할 수 있습니다.