Class CameraDevice

名前空間

easyar

CameraDeviceはカメラデバイスを実装し、InputFrameを出力します（画像、カメラパラメータ、タイムスタンプを含む）。Windows、Mac、Android、iOSで利用可能です。 開いた後、start/stopを呼び出してデータの収集を開始および停止できます。start/stopは以前に設定されたカメラパラメータに影響しません。 デバイスが不要になったら、closeを呼び出して閉じることができます。close後は使用を継続しないでください。 CameraDeviceはinputFrameSourceを通じてInputFrameを出力します。inputFrameSourceをInputFrameSinkに接続して使用する必要があります。 bufferCapacityはInputFrameバッファの容量を表します。この数を超えるInputFrameがデバイスから出力され、解放されない場合、デバイスは新しいInputFrameを出力しなくなります。これは画面のフリーズなどの問題を引き起こす可能性があります。 Androidで使用する場合は、AndroidManifest.xmlにandroid.permission.CAMERA権限宣言を追加する必要があります。 iOSで使用する場合は、Info.plistにNSCameraUsageDescription権限宣言を追加する必要があります。

CameraDevice

コンストラクター

CameraDevice

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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を返します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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は一部のデバイスで互換性の問題があります。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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を呼び出す前に設定する必要があります。そうしないと効果がありません。 推奨は、CameraDeviceSelectorを使用して、使用する主要なアルゴリズムに基づいて推奨Camera APIが設定されたCameraDeviceを作成することです。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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です。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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バッファの容量を設定します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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の出力ポートです。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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プラットフォームでのみ有効です。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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スレッドでこの関数を呼び出す必要があります。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

オペレーティングシステムが認識したカメラの数を取得します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

カメラのインデックスに従ってカメラデバイスを開きます。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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では、カメラタイプを判別できません。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

カメラデバイスタイプに従ってカメラデバイスを開きます。一致するタイプがない場合は最初のカメラデバイスを開こうとします。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

データの収集を開始します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

データの収集を停止します。この方法は画像のキャプチャのみを停止し、すべてのパラメータと接続は影響を受けません。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

カメラを閉じます。close後は使用を継続しないでください。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

カメラのインデックス。openが成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

カメラのタイプ。openが成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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が成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

カメラパラメータ。画像サイズ、焦点距離、主点、カメラタイプ、およびデバイスの自然な方向に対するカメラの相対的な回転角度を含みます。openが成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

カメラパラメータを設定します。openが成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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が成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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が成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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が成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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が変更される可能性があります。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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が成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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が成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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番目の上限を取得します。openが成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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を使用して最小値と最大値を取得できます。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

現在のデバイスの現在のフレームレート範囲のインデックスを設定します。openが成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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に設定します。openが成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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に設定します。openが成功した後に呼び出します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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の場合のみ使用できます。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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