Table of Contents

Class ARCoreCameraDevice

네임스페이스
easyar

ARCoreCameraDevice는 ARCore 기반 camera 장치를 구현하며 InputFrame(image, camera parameters, timestamp, 6DOF 위치 정보 및 tracking status 포함)을 출력합니다. 사용하기 전에 java.lang.System.loadLibrary를 사용하여 libarcore_sdk_c.so를 로드해야 합니다. 생성 후 start/stop을 호출하여 video stream data 수집을 시작하고 중지할 수 있습니다. 장치가 더 이상 필요하지 않으면 close를 호출하여 닫을 수 있습니다. close 후에는 계속 사용하면 안 됩니다. ARCoreCameraDevice는 inputFrameSource를 통해 InputFrame을 출력하므로, inputFrameSource를 InputFrameSink에 연결하여 사용해야 합니다. bufferCapacity는 InputFrame 버퍼의 용량을 나타냅니다. 이 수보다 많은 InputFrame이 장치에서 출력되고 해제되지 않으면, 이전 InputFrame이 해제될 때까지 장치는 새 InputFrame을 더 이상 출력하지 않습니다. 이로 인해 화면이 멈추는 등의 문제가 발생할 수 있습니다. 주의: 현재 ARCore(v1.13.0) 구현은 session 생성 및 파괴 시 메모리 누수가 있습니다. 반복적으로 생성하고 파괴하면 메모리 사용량이 계속 증가하며 파괴 후에도 해제되지 않습니다.

ARCoreCameraDevice

생성자

ARCoreCameraDevice 

void easyar_ARCoreCameraDevice__ctor(easyar_ARCoreCameraDevice * * Return)
ARCoreCameraDevice()
public ARCoreCameraDevice()
constructor()
+ (easyar_ARCoreCameraDevice *) create
public convenience init()
public ARCoreCameraDevice()

메서드

isAvailable

사용 가능한지 확인합니다. Android 시스템에서 ARCore가 설치되어 있을 때만 true를 반환합니다. libarcore_sdk_c.so를 로드하지 않고 호출하면 false를 반환합니다. 주의: 장치가 ARCore를 지원하지 않지만 ARCore apk가 sideload 방식으로 설치된 경우 이 함수는 true를 반환하지만 ARCore는 정상적으로 사용할 수 없습니다.

bool easyar_ARCoreCameraDevice_isAvailable(void)
static bool isAvailable()
public static boolean isAvailable()
companion object fun isAvailable(): Boolean
+ (bool)isAvailable
public static func isAvailable() -> Bool
public static bool isAvailable()

반환 값

형식 설명
Boolean

isDeviceSupported

현재 장치가 지원되는지 확인합니다.

bool easyar_ARCoreCameraDevice_isDeviceSupported(void)
static bool isDeviceSupported()
public static boolean isDeviceSupported()
companion object fun isDeviceSupported(): Boolean
+ (bool)isDeviceSupported
public static func isDeviceSupported() -> Bool
public static bool isDeviceSupported()

반환 값

형식 설명
Boolean

bufferCapacity

InputFrame 버퍼의 용량입니다. 기본값은 8입니다.

int easyar_ARCoreCameraDevice_bufferCapacity(const easyar_ARCoreCameraDevice * This)
int bufferCapacity()
public int bufferCapacity()
fun bufferCapacity(): Int
- (int)bufferCapacity
public func bufferCapacity() -> Int32
public virtual int bufferCapacity()

반환 값

형식 설명
Int32

setBufferCapacity

InputFrame 버퍼의 용량을 설정합니다.

void easyar_ARCoreCameraDevice_setBufferCapacity(easyar_ARCoreCameraDevice * This, int capacity)
void setBufferCapacity(int capacity)
public void setBufferCapacity(int capacity)
fun setBufferCapacity(capacity: Int): Unit
- (void)setBufferCapacity:(int)capacity
public func setBufferCapacity(_ capacity: Int32) -> Void
public virtual void setBufferCapacity(int capacity)

매개 변수

이름 형식 설명
capacity Int32

반환 값

형식 설명
Void

inputFrameSource

InputFrame 출력 포트입니다.

void easyar_ARCoreCameraDevice_inputFrameSource(easyar_ARCoreCameraDevice * This, easyar_InputFrameSource * * Return)
std::shared_ptr<InputFrameSource> inputFrameSource()
public @Nonnull InputFrameSource inputFrameSource()
fun inputFrameSource(): InputFrameSource
- (easyar_InputFrameSource *)inputFrameSource
public func inputFrameSource() -> InputFrameSource
public virtual InputFrameSource inputFrameSource()

반환 값

형식 설명
InputFrameSource

setFocusMode

focus mode를 focusMode로 설정합니다.

void easyar_ARCoreCameraDevice_setFocusMode(easyar_ARCoreCameraDevice * This, easyar_ARCoreCameraDeviceFocusMode focusMode)
void setFocusMode(ARCoreCameraDeviceFocusMode focusMode)
public void setFocusMode(int focusMode)
fun setFocusMode(focusMode: Int): Unit
- (void)setFocusMode:(easyar_ARCoreCameraDeviceFocusMode)focusMode
public func setFocusMode(_ focusMode: ARCoreCameraDeviceFocusMode) -> Void
public virtual void setFocusMode(ARCoreCameraDeviceFocusMode focusMode)

매개 변수

이름 형식 설명
focusMode ARCoreCameraDeviceFocusMode

반환 값

형식 설명
Void

start

video stream data 수집을 시작합니다.

bool easyar_ARCoreCameraDevice_start(easyar_ARCoreCameraDevice * This)
bool start()
public boolean start()
fun start(): Boolean
- (bool)start
public func start() -> Bool
public virtual bool start()

반환 값

형식 설명
Boolean

stop

video stream data 수집을 중지합니다.

void easyar_ARCoreCameraDevice_stop(easyar_ARCoreCameraDevice * This)
void stop()
public void stop()
fun stop(): Unit
- (void)stop
public func stop() -> Void
public virtual void stop()

반환 값

형식 설명
Void

close

닫습니다. close 후에는 계속 사용하면 안 됩니다.

void easyar_ARCoreCameraDevice_close(easyar_ARCoreCameraDevice * This)
void close()
public void close()
fun close(): Unit
- (void)close
public func close() -> Void
public virtual void close()

반환 값

형식 설명
Void

type

camera 타입입니다.

easyar_CameraDeviceType easyar_ARCoreCameraDevice_type(const easyar_ARCoreCameraDevice * This)
CameraDeviceType type()
public int type()
fun type(): Int
- (easyar_CameraDeviceType)type
public func type() -> CameraDeviceType
public virtual CameraDeviceType type()

반환 값

형식 설명
CameraDeviceType

cameraOrientation

camera 이미지를 장치의 자연 방향으로 표시할 때 필요한 시계 방향 회전 각도입니다.

int easyar_ARCoreCameraDevice_cameraOrientation(const easyar_ARCoreCameraDevice * This)
int cameraOrientation()
public int cameraOrientation()
fun cameraOrientation(): Int
- (int)cameraOrientation
public func cameraOrientation() -> Int32
public virtual int cameraOrientation()

반환 값

형식 설명
Int32

size

현재 image 크기를 가져옵니다.

easyar_Vec2I easyar_ARCoreCameraDevice_size(const easyar_ARCoreCameraDevice * This)
Vec2I size()
public @Nonnull Vec2I size()
fun size(): Vec2I
- (easyar_Vec2I *)size
public func size() -> Vec2I
public virtual Vec2I size()

반환 값

형식 설명
Vec2I

frameRateRangeLower

현재 frame rate 범위의 하한을 가져옵니다.

double easyar_ARCoreCameraDevice_frameRateRangeLower(const easyar_ARCoreCameraDevice * This)
double frameRateRangeLower()
public double frameRateRangeLower()
fun frameRateRangeLower(): Double
- (double)frameRateRangeLower
public func frameRateRangeLower() -> Double
public virtual double frameRateRangeLower()

반환 값

형식 설명
Double

frameRateRangeUpper

현재 frame rate 범위의 상한을 가져옵니다.

double easyar_ARCoreCameraDevice_frameRateRangeUpper(const easyar_ARCoreCameraDevice * This)
double frameRateRangeUpper()
public double frameRateRangeUpper()
fun frameRateRangeUpper(): Double
- (double)frameRateRangeUpper
public func frameRateRangeUpper() -> Double
public virtual double frameRateRangeUpper()

반환 값

형식 설명
Double