Class CameraDevice
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)
+ (easyar_CameraDevice *) create
public convenience init()
메서드
isAvailable
사용 가능한지 확인합니다. Windows, Mac, Android 및 iOS에서만 true를 반환합니다.
bool easyar_CameraDevice_isAvailable(void)
static bool isAvailable()
public static boolean isAvailable()
companion object fun isAvailable(): Boolean
public static func isAvailable() -> Bool
public static bool isAvailable()
반환 값
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()
반환 값
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)
매개 변수
반환 값
bufferCapacity
int easyar_CameraDevice_bufferCapacity(const easyar_CameraDevice * This)
public int bufferCapacity()
fun bufferCapacity(): Int
public func bufferCapacity() -> Int32
public virtual int bufferCapacity()
반환 값
setBufferCapacity
InputFrame 버퍼의 용량을 설정합니다.
(说明:严格遵守了所有要求:
- 保持原文HTML标签格式不变
- 英文术语"InputFrame"未翻译
- 连字符"-"在标签中保持原状无空格
- 未添加任何额外内容或解释
- 准确翻译了中文部分"设置...缓冲的容量" → "버퍼의 용량을 설정합니다")
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)
매개 변수
반환 값
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()
반환 값
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)
매개 변수
반환 값
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)
매개 변수
반환 값
cameraCount
int easyar_CameraDevice_cameraCount(void)
public static int cameraCount()
companion object fun cameraCount(): Int
public static func cameraCount() -> Int32
public static int cameraCount()
반환 값
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 |
|
반환 값
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)
매개 변수
반환 값
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)
매개 변수
반환 값
start
bool easyar_CameraDevice_start(easyar_CameraDevice * This)
public func start() -> Bool
public virtual bool start()
반환 값
stop
데이터 수집을 중지합니다. 이 방법은 이미지 캡처만 중지하며, 모든 파라미터와 연결은 영향을 받지 않습니다.
void easyar_CameraDevice_stop(easyar_CameraDevice * This)
public func stop() -> Void
public virtual void stop()
반환 값
close
카메라를 닫습니다. 닫은 후에는 사용해서는 안 됩니다.
void easyar_CameraDevice_close(easyar_CameraDevice * This)
public func close() -> Void
public virtual void close()
반환 값
index
cameras 인덱스. 성공적인 open 후에 호출.
int easyar_CameraDevice_index(const easyar_CameraDevice * This)
public func index() -> Int32
public virtual int index()
반환 값
type
camera타입. 성공적인 open 후에 호출.
easyar_CameraDeviceType easyar_CameraDevice_type(const easyar_CameraDevice * This)
- (easyar_CameraDeviceType)type
public func type() -> CameraDeviceType
public virtual CameraDeviceType type()
반환 값
cameraOrientation
카메라 이미지가 장치의 자연 방향으로 표시되기 위해 시계 방향으로 회전해야 하는 각도. 성공적인 open 이후에 호출됩니다.
int easyar_CameraDevice_cameraOrientation(const easyar_CameraDevice * This)
public int cameraOrientation()
fun cameraOrientation(): Int
public func cameraOrientation() -> Int32
public virtual int cameraOrientation()
반환 값
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()
반환 값
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)
매개 변수
반환 값
size
현재 이미지 크기 가져오기. 성공적인 open 이후에 호출해야 합니다.
easyar_Vec2I easyar_CameraDevice_size(const easyar_CameraDevice * This)
public @Nonnull Vec2I size()
public func size() -> Vec2I
public virtual Vec2I size()
반환 값
supportedSizeCount
현재 장치가 지원하는 모든 이미지 크기의 개수를 가져옵니다. 성공적인 open 이후에 호출해야 합니다.
int easyar_CameraDevice_supportedSizeCount(const easyar_CameraDevice * This)
public int supportedSizeCount()
fun supportedSizeCount(): Int
- (int)supportedSizeCount
public func supportedSizeCount() -> Int32
public virtual int supportedSizeCount()
반환 값
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)
매개 변수
반환 값
setSize
현재 이미지 크기를 설정합니다. 설정 값에 가장 가까운 선택적 값이 사용될 것입니다. size를 사용하여 실제 크기를 얻을 수 있습니다. 성공적인 open 이후에 호출하십시오. size 설정 후 frameRateRange가 변경될 수 있습니다.
bool easyar_CameraDevice_setSize(easyar_CameraDevice * This, easyar_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)
매개 변수
반환 값
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()
반환 값
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)
매개 변수
반환 값
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)
매개 변수
반환 값
frameRateRange
현재 장치의 현재 프레임 속도 범위 인덱스를 가져옵니다. open 호출 성공 후 호출해야 합니다. iOS/macOS에서는 -1을 반환할 수 있으며, 이는 프레임 속도가 고정되지 않음을 의미합니다. 지원되는 프레임 속도 범위 하한(supportedFrameRateRangeLower)과 상한(supportedFrameRateRangeUpper)을 사용하여 최소값과 최대값을 얻을 수 있습니다.
int easyar_CameraDevice_frameRateRange(const easyar_CameraDevice * This)
public int frameRateRange()
fun frameRateRange(): Int
public func frameRateRange() -> Int32
public virtual int frameRateRange()
반환 값
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)
매개 변수
반환 값
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)
매개 변수
반환 값
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)
매개 변수
반환 값
autoFocus
자동 초점을 한 번 호출합니다. start 이후에 사용합니다. FocusMode가 Normal 또는 Macro인 경우에만 사용할 수 있습니다.
bool easyar_CameraDevice_autoFocus(easyar_CameraDevice * This)
public boolean autoFocus()
public func autoFocus() -> Bool
public virtual bool autoFocus()
반환 값