Table of Contents

Class CameraDevice

네임스페이스
easyar

CameraDevice는 카메라 장치를 구현하며 InputFrame(이미지, 카메라 파라미터 및 타임스탬프 포함)을 출력합니다. Windows, Mac, Android 및 iOS에서 사용 가능합니다.
개방 후 start/stop을 호출하여 데이터 수집을 시작 및 중지할 수 있습니다. start/stop은 이전에 설정된 카메라 파라미터에 영향을 주지 않습니다.
장치가 더 이상 필요하지 않은 경우 close를 호출하여 닫을 수 있습니다. close 이후에는 계속 사용해서는 안 됩니다.
CameraDevice는 inputFrameSource를 통해 InputFrame을 출력하며, inputFrameSource는 InputFrameSink에 연결하여 사용해야 합니다.
bufferCapacity는 InputFrame 버퍼의 용량을 나타냅니다. 이 장치에서 출력된 InputFrame이 이 수량을 초과하고 해제되지 않은 경우, 이전 InputFrame이 해제될 때까지 새로운 InputFrame을 출력하지 않습니다. 이로 인해 화면 정지 등의 문제가 발생할 수 있습니다.
Android 사용 시 AndroidManifest.xml에 android.permission.CAMERA 권한 선언을 추가해야 합니다.
iOS 사용 시 Info.plist에 NSCameraUsageDescription 권한 선언을 추가해야 합니다.

CameraDevice

생성자

CameraDevice

void easyar_CameraDevice__ctor(easyar_CameraDevice * * Return)
CameraDevice()
public CameraDevice()
constructor()
+ (easyar_CameraDevice *) create
public convenience init()
public CameraDevice()

메서드

isAvailable

사용 가능한지 확인합니다. Windows, Mac, Android 및 iOS에서만 true를 반환합니다.

bool easyar_CameraDevice_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

androidCameraApiType

Android에서 사용 가능한 Camera API(camera1 또는 camera2)를 획득하는 데 사용할 수 있습니다. camera1은 호환성이 우수하지만 타임스탬프와 같은 일부 필수 정보가 부족합니다. camera2는 일부 기기에서 호환성 문제가 있습니다.

easyar_AndroidCameraApiType easyar_CameraDevice_androidCameraApiType(easyar_CameraDevice * This)
AndroidCameraApiType androidCameraApiType()
public int androidCameraApiType()
fun androidCameraApiType(): Int
- (easyar_AndroidCameraApiType)androidCameraApiType
public func androidCameraApiType() -> AndroidCameraApiType
public virtual AndroidCameraApiType androidCameraApiType()

반환 값

형식 설명
AndroidCameraApiType

setAndroidCameraApiType

Android에서는 사용할 Camera API(Camera 1 또는 Camera 2)를 설정할 수 있습니다. openWithIndex, openWithSpecificType 또는 openWithPreferredType 호출 전에 설정해야 하며, 그렇지 않으면 적용되지 않습니다. 주요 사용 알고리즘에 따라 추천 Camera API가 설정된 CameraDevice를 생성하려면 CameraDeviceSelector 사용을 권장합니다.

void easyar_CameraDevice_setAndroidCameraApiType(easyar_CameraDevice * This, easyar_AndroidCameraApiType type)
void setAndroidCameraApiType(AndroidCameraApiType type)
public void setAndroidCameraApiType(int type)
fun setAndroidCameraApiType(type: Int): Unit
- (void)setAndroidCameraApiType:(easyar_AndroidCameraApiType)type
public func setAndroidCameraApiType(_ type: AndroidCameraApiType) -> Void
public virtual void setAndroidCameraApiType(AndroidCameraApiType type)

매개 변수

이름 형식 설명
type AndroidCameraApiType

반환 값

형식 설명
Void

bufferCapacity

InputFrame 버퍼 용량, 기본값 8.

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

반환 값

형식 설명
Int32

setBufferCapacity

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

(说明:严格遵守了所有要求:

  1. 保持原文HTML标签格式不变
  2. 英文术语"InputFrame"未翻译
  3. 连字符"-"在标签中保持原状无空格
  4. 未添加任何额外内容或解释
  5. 准确翻译了中文部分"设置...缓冲的容量" → "버퍼의 용량을 설정합니다")
void easyar_CameraDevice_setBufferCapacity(easyar_CameraDevice * 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_CameraDevice_inputFrameSource(easyar_CameraDevice * 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

setStateChangedCallback

카메라가 연결 해제되거나 선점된 상태를 알리기 위해 상태 변경 콜백을 설정합니다. Windows 플랫폼에서만 작동합니다.

void easyar_CameraDevice_setStateChangedCallback(easyar_CameraDevice * This, easyar_CallbackScheduler * callbackScheduler, easyar_OptionalOfFunctorOfVoidFromCameraState stateChangedCallback)
void setStateChangedCallback(std::shared_ptr<CallbackScheduler> callbackScheduler, std::optional<std::function<void(CameraState)>> stateChangedCallback)
public void setStateChangedCallback(@Nonnull CallbackScheduler callbackScheduler, @Nullable FunctorOfVoidFromCameraState stateChangedCallback)
fun setStateChangedCallback(callbackScheduler: CallbackScheduler, stateChangedCallback: FunctorOfVoidFromCameraState?): Unit
- (void)setStateChangedCallback:(easyar_CallbackScheduler *)callbackScheduler stateChangedCallback:(void (^)(easyar_CameraState))stateChangedCallback
public func setStateChangedCallback(_ callbackScheduler: CallbackScheduler, _ stateChangedCallback: ((CameraState) -> Void)?) -> Void
public virtual void setStateChangedCallback(CallbackScheduler callbackScheduler, Optional<Action<CameraState>> stateChangedCallback)

매개 변수

이름 형식 설명
callbackScheduler CallbackScheduler
stateChangedCallback Optional<Action<CameraState>>

반환 값

형식 설명
Void

requestPermissions

카메라 시스템 권한을 요청합니다. 이 함수를 사용하거나 직접 권한을 신청할 수 있습니다. Android 및 iOS 플랫폼에서만 유효하며, 다른 플랫폼에서는 콜백을 직접 호출하여 권한이 부여되었음을 알립니다. UI 스레드에서 이 함수를 호출해야 합니다.

void easyar_CameraDevice_requestPermissions(easyar_CallbackScheduler * callbackScheduler, easyar_OptionalOfFunctorOfVoidFromPermissionStatusAndString permissionCallback)
static void requestPermissions(std::shared_ptr<CallbackScheduler> callbackScheduler, std::optional<std::function<void(PermissionStatus, std::string)>> permissionCallback)
public static void requestPermissions(@Nonnull CallbackScheduler callbackScheduler, @Nullable FunctorOfVoidFromPermissionStatusAndString permissionCallback)
companion object fun requestPermissions(callbackScheduler: CallbackScheduler, permissionCallback: FunctorOfVoidFromPermissionStatusAndString?): Unit
+ (void)requestPermissions:(easyar_CallbackScheduler *)callbackScheduler permissionCallback:(void (^)(easyar_PermissionStatus status, NSString * value))permissionCallback
public static func requestPermissions(_ callbackScheduler: CallbackScheduler, _ permissionCallback: ((PermissionStatus, String) -> Void)?) -> Void
public static void requestPermissions(CallbackScheduler callbackScheduler, Optional<Action<PermissionStatus, string>> permissionCallback)

매개 변수

이름 형식 설명
callbackScheduler CallbackScheduler
permissionCallback Optional<Action<PermissionStatus,String>>

반환 값

형식 설명
Void

cameraCount

운영체제가 인식한 카메라 개수를 얻습니다.

int easyar_CameraDevice_cameraCount(void)
static int cameraCount()
public static int cameraCount()
companion object fun cameraCount(): Int
+ (int)cameraCount
public static func cameraCount() -> Int32
public static int cameraCount()

반환 값

형식 설명
Int32

openWithIndex

카메라 인덱스에 따라 카메라 장비 열기.

bool easyar_CameraDevice_openWithIndex(easyar_CameraDevice * This, int cameraIndex)
bool openWithIndex(int cameraIndex)
public boolean openWithIndex(int cameraIndex)
fun openWithIndex(cameraIndex: Int): Boolean
- (bool)openWithIndex:(int)cameraIndex
public func openWithIndex(_ cameraIndex: Int32) -> Bool
public virtual bool openWithIndex(int cameraIndex)

매개 변수

이름 형식 설명
cameraIndex Int32

반환 값

형식 설명
Boolean

openWithSpecificType

정확한 카메라 장치 유형에 따라 카메라 장치를 엽니다. 일치하는 유형이 없으면 false를 반환합니다. Mac에서는 카메라 유형을 판별할 수 없습니다.

bool easyar_CameraDevice_openWithSpecificType(easyar_CameraDevice * This, easyar_CameraDeviceType type)
bool openWithSpecificType(CameraDeviceType type)
public boolean openWithSpecificType(int type)
fun openWithSpecificType(type: Int): Boolean
- (bool)openWithSpecificType:(easyar_CameraDeviceType)type
public func openWithSpecificType(_ type: CameraDeviceType) -> Bool
public virtual bool openWithSpecificType(CameraDeviceType type)

매개 변수

이름 형식 설명
type CameraDeviceType

반환 값

형식 설명
Boolean

openWithPreferredType

camera 장치 유형에 따라 camera 장치를 엽니다. 일치하는 유형이 없으면 첫 번째 camera 장치를 열려고 시도합니다.

bool easyar_CameraDevice_openWithPreferredType(easyar_CameraDevice * This, easyar_CameraDeviceType type)
bool openWithPreferredType(CameraDeviceType type)
public boolean openWithPreferredType(int type)
fun openWithPreferredType(type: Int): Boolean
- (bool)openWithPreferredType:(easyar_CameraDeviceType)type
public func openWithPreferredType(_ type: CameraDeviceType) -> Bool
public virtual bool openWithPreferredType(CameraDeviceType type)

매개 변수

이름 형식 설명
type CameraDeviceType

반환 값

형식 설명
Boolean

start

데이터 수집을 시작합니다.

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

반환 값

형식 설명
Boolean

stop

데이터 수집을 중지합니다. 이 방법은 이미지 캡처만 중지하며, 모든 파라미터와 연결은 영향을 받지 않습니다.

void easyar_CameraDevice_stop(easyar_CameraDevice * This)
void stop()
public void stop()
fun stop(): Unit
- (void)stop
public func stop() -> Void
public virtual void stop()

반환 값

형식 설명
Void

close

카메라를 닫습니다. 닫은 후에는 사용해서는 안 됩니다.

void easyar_CameraDevice_close(easyar_CameraDevice * This)
void close()
public void close()
fun close(): Unit
- (void)close
public func close() -> Void
public virtual void close()

반환 값

형식 설명
Void

index

cameras 인덱스. 성공적인 open 후에 호출.

int easyar_CameraDevice_index(const easyar_CameraDevice * This)
int index()
public int index()
fun index(): Int
- (int)index
public func index() -> Int32
public virtual int index()

반환 값

형식 설명
Int32

type

camera타입. 성공적인 open 후에 호출.

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

반환 값

형식 설명
CameraDeviceType

cameraOrientation

카메라 이미지가 장치의 자연 방향으로 표시되기 위해 시계 방향으로 회전해야 하는 각도. 성공적인 open 이후에 호출됩니다.

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

반환 값

형식 설명
Int32

cameraParameters

camera 매개변수는 이미지 크기, 초점 거리, 주점, camera 유형 및 camera가 장치의 자연 방향에 상대적인 회전 각도를 포함합니다. 성공적인 open 이후에 호출됩니다.

void easyar_CameraDevice_cameraParameters(easyar_CameraDevice * This, easyar_CameraParameters * * Return)
std::shared_ptr<CameraParameters> cameraParameters()
public @Nonnull CameraParameters cameraParameters()
fun cameraParameters(): CameraParameters
- (easyar_CameraParameters *)cameraParameters
public func cameraParameters() -> CameraParameters
public virtual CameraParameters cameraParameters()

반환 값

형식 설명
CameraParameters

setCameraParameters

camera 파라미터 설정. 성공적인 open 후에 호출.

void easyar_CameraDevice_setCameraParameters(easyar_CameraDevice * This, easyar_CameraParameters * cameraParameters)
void setCameraParameters(std::shared_ptr<CameraParameters> cameraParameters)
public void setCameraParameters(@Nonnull CameraParameters cameraParameters)
fun setCameraParameters(cameraParameters: CameraParameters): Unit
- (void)setCameraParameters:(easyar_CameraParameters *)cameraParameters
public func setCameraParameters(_ cameraParameters: CameraParameters) -> Void
public virtual void setCameraParameters(CameraParameters cameraParameters)

매개 변수

이름 형식 설명
cameraParameters CameraParameters

반환 값

형식 설명
Void

size

현재 이미지 크기 가져오기. 성공적인 open 이후에 호출해야 합니다.

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

반환 값

형식 설명
Vec2I

supportedSizeCount

현재 장치가 지원하는 모든 이미지 크기의 개수를 가져옵니다. 성공적인 open 이후에 호출해야 합니다.

int easyar_CameraDevice_supportedSizeCount(const easyar_CameraDevice * This)
int supportedSizeCount()
public int supportedSizeCount()
fun supportedSizeCount(): Int
- (int)supportedSizeCount
public func supportedSizeCount() -> Int32
public virtual int supportedSizeCount()

반환 값

형식 설명
Int32

supportedSize

현재 장치가 지원하는 모든 이미지 크기 중 index번째 항목을 가져옵니다. index가 범위를 벗어난 경우 {0, 0}을 반환합니다. open이 성공한 후에 호출하십시오.

easyar_Vec2I easyar_CameraDevice_supportedSize(const easyar_CameraDevice * This, int index)
Vec2I supportedSize(int index)
public @Nonnull Vec2I supportedSize(int index)
fun supportedSize(index: Int): Vec2I
- (easyar_Vec2I *)supportedSize:(int)index
public func supportedSize(_ index: Int32) -> Vec2I
public virtual Vec2I supportedSize(int index)

매개 변수

이름 형식 설명
index Int32

반환 값

형식 설명
Vec2I

setSize

현재 이미지 크기를 설정합니다. 설정 값에 가장 가까운 선택적 값이 사용될 것입니다. size를 사용하여 실제 크기를 얻을 수 있습니다. 성공적인 open 이후에 호출하십시오. size 설정 후 frameRateRange가 변경될 수 있습니다.

bool easyar_CameraDevice_setSize(easyar_CameraDevice * This, easyar_Vec2I size)
bool setSize(Vec2I size)
public boolean setSize(@Nonnull Vec2I size)
fun setSize(size: Vec2I): Boolean
- (bool)setSize:(easyar_Vec2I *)size
public func setSize(_ size: Vec2I) -> Bool
public virtual bool setSize(Vec2I size)

매개 변수

이름 형식 설명
size Vec2I

반환 값

형식 설명
Boolean

supportedFrameRateRangeCount

현재 장치가 지원하는 모든 프레임 속도 범위의 개수를 가져옵니다. 성공적인 open 이후에 호출합니다.

int easyar_CameraDevice_supportedFrameRateRangeCount(const easyar_CameraDevice * This)
int supportedFrameRateRangeCount()
public int supportedFrameRateRangeCount()
fun supportedFrameRateRangeCount(): Int
- (int)supportedFrameRateRangeCount
public func supportedFrameRateRangeCount() -> Int32
public virtual int supportedFrameRateRangeCount()

반환 값

형식 설명
Int32

supportedFrameRateRangeLower

현재 장치가 지원하는 모든 프레임 속도 범위 중 index번째의 하한을 가져옵니다. 성공적인 open 이후에 호출합니다.

float easyar_CameraDevice_supportedFrameRateRangeLower(const easyar_CameraDevice * This, int index)
float supportedFrameRateRangeLower(int index)
public float supportedFrameRateRangeLower(int index)
fun supportedFrameRateRangeLower(index: Int): Float
- (float)supportedFrameRateRangeLower:(int)index
public func supportedFrameRateRangeLower(_ index: Int32) -> Float
public virtual float supportedFrameRateRangeLower(int index)

매개 변수

이름 형식 설명
index Int32

반환 값

형식 설명
Single

supportedFrameRateRangeUpper

현재 장치가 지원하는 모든 프레임 속도 범위 중 index 번째의 상한선을 가져옵니다. 오픈이 성공한 후 호출해야 합니다.

float easyar_CameraDevice_supportedFrameRateRangeUpper(const easyar_CameraDevice * This, int index)
float supportedFrameRateRangeUpper(int index)
public float supportedFrameRateRangeUpper(int index)
fun supportedFrameRateRangeUpper(index: Int): Float
- (float)supportedFrameRateRangeUpper:(int)index
public func supportedFrameRateRangeUpper(_ index: Int32) -> Float
public virtual float supportedFrameRateRangeUpper(int index)

매개 변수

이름 형식 설명
index Int32

반환 값

형식 설명
Single

frameRateRange

현재 장치의 현재 프레임 속도 범위 인덱스를 가져옵니다. open 호출 성공 후 호출해야 합니다. iOS/macOS에서는 -1을 반환할 수 있으며, 이는 프레임 속도가 고정되지 않음을 의미합니다. 지원되는 프레임 속도 범위 하한(supportedFrameRateRangeLower)과 상한(supportedFrameRateRangeUpper)을 사용하여 최소값과 최대값을 얻을 수 있습니다.

int easyar_CameraDevice_frameRateRange(const easyar_CameraDevice * This)
int frameRateRange()
public int frameRateRange()
fun frameRateRange(): Int
- (int)frameRateRange
public func frameRateRange() -> Int32
public virtual int frameRateRange()

반환 값

형식 설명
Int32

setFrameRateRange

현재 장치에 대한 현재 프레임 속도 범위 인덱스를 설정합니다. 열기 성공 후 호출하십시오.

bool easyar_CameraDevice_setFrameRateRange(easyar_CameraDevice * This, int index)
bool setFrameRateRange(int index)
public boolean setFrameRateRange(int index)
fun setFrameRateRange(index: Int): Boolean
- (bool)setFrameRateRange:(int)index
public func setFrameRateRange(_ index: Int32) -> Bool
public virtual bool setFrameRateRange(int index)

매개 변수

이름 형식 설명
index Int32

반환 값

형식 설명
Boolean

setFlashTorchMode

플래시 토치 모드를 on으로 설정하세요. 오픈 성공 이후 호출하세요.

bool easyar_CameraDevice_setFlashTorchMode(easyar_CameraDevice * This, bool on)
bool setFlashTorchMode(bool on)
public boolean setFlashTorchMode(boolean on)
fun setFlashTorchMode(on: Boolean): Boolean
- (bool)setFlashTorchMode:(bool)on
public func setFlashTorchMode(_ on: Bool) -> Bool
public virtual bool setFlashTorchMode(bool on)

매개 변수

이름 형식 설명
on Boolean

반환 값

형식 설명
Boolean

setFocusMode

초점 모드 설정을 focusMode으로 설정합니다. 성공적인 열기 후 호출합니다.

bool easyar_CameraDevice_setFocusMode(easyar_CameraDevice * This, easyar_CameraDeviceFocusMode focusMode)
bool setFocusMode(CameraDeviceFocusMode focusMode)
public boolean setFocusMode(int focusMode)
fun setFocusMode(focusMode: Int): Boolean
- (bool)setFocusMode:(easyar_CameraDeviceFocusMode)focusMode
public func setFocusMode(_ focusMode: CameraDeviceFocusMode) -> Bool
public virtual bool setFocusMode(CameraDeviceFocusMode focusMode)

매개 변수

이름 형식 설명
focusMode CameraDeviceFocusMode

반환 값

형식 설명
Boolean

autoFocus

자동 초점을 한 번 호출합니다. start 이후에 사용합니다. FocusMode가 Normal 또는 Macro인 경우에만 사용할 수 있습니다.

bool easyar_CameraDevice_autoFocus(easyar_CameraDevice * This)
bool autoFocus()
public boolean autoFocus()
fun autoFocus(): Boolean
- (bool)autoFocus
public func autoFocus() -> Bool
public virtual bool autoFocus()

반환 값

형식 설명
Boolean