본문으로 건너뛰기

Software Development Kits (SDKs)

DigiCAP Content Authenticity 서비스를 쉽게 통합할 수 있도록 iOS SDK를 제공합니다. SDK는 C2PA 서명, 미디어 검증, 지문 인식, 콘텐츠 인증 기능을 포함합니다.

지원 플랫폼​

플랫폼버전상태설치 방법
iOSv0.0.1✅ 지원.a 파일
Android-🔄 추후 지원 예정-

iOS SDK (BornIDSDK)​

설치​

현재 SDK는 .a 파일 형태로 제공할 예정입니다. 설치 방법에 대한 자세한 내용은 아래 이메일로 문의해 주세요.

문의: info.bornid@digicaps.com

초기화​

import BornIDSDK

// SDK 설정
BornIDSDK.shared.configure(baseURL: URL, apiKey: String)

API 레퍼런스​

사용자 인증​

사용자 계정으로 로그인하여 SDK의 모든 기능을 사용할 수 있습니다.

// 로그인
BornIDSDK.shared.login(email: String, password: String) async throws -> User

// 사용법
let user = try await BornIDSDK.shared.login(email: "user@example.com", password: "password")

현재 로그인된 사용자의 세션을 종료합니다.

// 로그아웃
BornIDSDK.shared.logout() async

// 사용법
await BornIDSDK.shared.logout()

사용자가 현재 로그인되어 있는지 확인합니다.

// 로그인 상태 확인
BornIDSDK.shared.isLoggedIn() async -> Bool

// 사용법
let isLoggedIn = await BornIDSDK.shared.isLoggedIn()

최신 사용자 정보를 조회합니다.

// 사용자 정보 갱신
BornIDSDK.shared.fetchMyProfile() async throws -> User

// 사용법
let user = try await BornIDSDK.shared.fetchMyProfile()

미디어 업로드​

이미지나 비디오 파일을 서버에 업로드합니다. 위치 정보와 설명을 포함할 수 있으며, 선택적으로 미디어 지문(fingerprint)도 생성할 수 있습니다.

// 미디어 업로드
BornIDSDK.shared.uploadMedia(
    companyId: String, 
    data: Data, 
    mediaType: MediaType, 
    location: CLLocation, 
    description: String? = nil, 
    fingerprint: Bool? = nil
) async throws -> URL

// 사용법
let uploadURL = try await BornIDSDK.shared.uploadMedia(
    companyId: "company-id",
    data: imageData,
    mediaType: .image,
    location: currentLocation,
    description: "설명",
    fingerprint: true
)

미디어 목록 조회​

특정 사용자가 업로드한 미디어 목록을 페이지 단위로 조회합니다. 한 번에 가져올 개수와 시작점을 지정할 수 있습니다.

// 미디어 목록 조회
BornIDSDK.shared.listMedia(
    userId: String, 
    limit: Int = 20, 
    offset: Int = 0
) async throws -> MediaListResponse

// 사용법
let mediaList = try await BornIDSDK.shared.listMedia(userId: "user-id", limit: 10)

미디어 검증​

미디어 파일에 포함된 C2PA 서명과 메타데이터를 분석하여 콘텐츠의 진위성을 검증합니다. 조작 여부와 출처 정보를 확인할 수 있습니다.

메모리에 있는 미디어 데이터의 진위성을 검증합니다. 결과는 JSON 형태로 반환됩니다.

// 데이터 검증
BornIDSDK.shared.verifyMedia(data: Data, ext: String) -> String?

// 사용법
let result = BornIDSDK.shared.verifyMedia(data: imageData, ext: "jpg")

파일 시스템에 저장된 미디어 파일의 진위성을 검증합니다. 파일 경로를 통해 접근하여 분석합니다.

// 파일 검증
BornIDSDK.shared.verifyMedia(fileURL: URL, ext: String) -> String?

// 사용법
let result = BornIDSDK.shared.verifyMedia(fileURL: imageURL, ext: "jpg")

위치 정보​

앱에서 위치 권한을 관리하고 현재 위치 정보를 확인할 수 있습니다.

// 위치 권한 상태 확인
BornIDSDK.shared.locationAuthorizationStatus() -> CLAuthorizationStatus

// 위치 권한 요청
BornIDSDK.shared.requestLocationPermission()

// 사용법
if BornIDSDK.shared.locationAuthorizationStatus() == .notDetermined {
    BornIDSDK.shared.requestLocationPermission()
}

설정 관리​

SDK의 다양한 설정을 관리할 수 있습니다.

// 설정 매니저 접근
BornIDSDK.shared.getSettingsManager() -> SettingsManager

// 사용법
let settingsManager = BornIDSDK.shared.getSettingsManager()

카메라 기능​

SDK에 내장된 카메라 화면을 표시하여 사진을 촬영할 수 있습니다. 촬영과 동시에 메타데이터를 수집하고 C2PA 서명을 적용할 수 있습니다.

// 카메라 화면 표시
BornIDSDK.shared.presentCamera(from: UIViewController, delegate: CameraViewControllerDelegate)

// 사용법
BornIDSDK.shared.presentCamera(from: self, delegate: self)

델리게이트 프로토콜​

CameraViewControllerDelegate​

protocol CameraViewControllerDelegate {
    func cameraViewController(_ controller: UIViewController, didCaptureImage image: UIImage, with metadata: [String: Any])
    func cameraViewControllerDidCancel(_ controller: UIViewController)
}

데이터 모델​

MediaType​

enum MediaType {
    case image
    case video
}

에러 처리​

SDK의 모든 비동기 함수는 Swift의 표준 에러 처리 방식을 사용합니다:

do {
    let user = try await BornIDSDK.shared.login(email: email, password: password)
    // 성공 처리
} catch {
    // 에러 처리
    print("오류: \(error.localizedDescription)")
}

지원 및 문의​

기술 지원​

시스템 요구사항​

  • iOS: 15.0 이상
  • Xcode: 14.0 이상
  • Swift: 5.0 이상