Class CameraDeviceFrameSource

가이드로 전환

네임스페이스

easyar

어셈블리

EasyAR.Sense.dll

씬에서 easyar.CameraDevice를 제어하는 MonoBehaviour로, Unity 환경에서 기능 확장을 제공합니다.

이 frame source는 모션 추적 장비가 아니며, ARSession에서 모션 데이터를 출력하지 않습니다.

[RequireComponent(typeof(CameraDeviceDisplay))]
public class CameraDeviceFrameSource : FrameSource

상속

object

Object

Component

Behaviour

MonoBehaviour

FrameSource

CameraDeviceFrameSource

파생

EditorCameraDeviceFrameSource

상속된 멤버

FrameSource.CheckAvailability()

필드

CameraOpenIndex

카메라를 열 때 사용하는 장치 인덱스, CameraOpenMethod == DeviceIndex일 때 사용되며, DeviceOpened 이벤트 전에 수정해야만 유효합니다.

[HideInInspector]
[SerializeField]
public int CameraOpenIndex

CameraOpenMethod

카메라를 열 때 사용하는 방법은 DeviceOpened 이벤트 전에 수정해야만 적용됩니다.

[HideInInspector]
[SerializeField]
public CameraDeviceFrameSource.CameraDeviceOpenMethod CameraOpenMethod

CameraOpenType

카메라를 열 때 사용하는 Camera 유형으로, CameraOpenMethod == PreferredType 또는 SpecificType일 때 사용되며, DeviceOpened 이벤트 전에 수정해야 유효합니다.

[HideInInspector]
[SerializeField]
public CameraDeviceType CameraOpenType

속성

AndroidCameraApiType

Android에서 사용 가능한 Camera API(camera1 또는 camera2)를 얻는 데 사용할 수 있습니다. Opened가 true일 때만 사용 가능합니다.

public AndroidCameraApiType AndroidCameraApiType { get; }

AvailableCenterMode

새로운 프레임 소스를 생성할 때만 제공됩니다. Assemble() 과정 중에만 접근됩니다.

사용 가능한 모든 중심 모드.

protected override IReadOnlyList<ARSession.ARCenterMode> AvailableCenterMode { get; }

Camera

새로운 프레임 소스를 생성할 때만 제공됩니다. 이는 Assemble() 과정에서만 접근됩니다.

데스크톱 기기나 휴대폰에서, 이 카메라는 현실 환경의 카메라 장치에 대응하는 가상 세계의 Camera를 나타내며, 프로젝션 매트릭스와 위치는 실제 카메라와 대응되어 EasyAR에 의해 제어됩니다. 헤드셋에서는, 이 카메라는 진단용 텍스트를 눈앞에 표시하는 데만 사용되며, 화면 렌더링에는 사용되지 않으며, 카메라도 EasyAR에 의해 제어되지 않습니다.

protected override Camera Camera { get; }

CameraCandidate

Camera의 대안, 설정되지 않은 경우 Camera.main이 사용됩니다.

public Camera CameraCandidate { get; set; }

CameraCount

운영 체제에서 인식된 camera 개수를 가져옵니다.

public static int CameraCount { get; }

CameraFrameStarted

새로운 frame source를 생성할 때만 제공됩니다. ARSession의 전체 수명 주기 동안 액세스됩니다.

카메라 프레임 입력 시작 여부.

protected override bool CameraFrameStarted { get; }

CameraType

camera 유형. Opened가 true일 때만 사용 가능합니다.

설명:

1. "camera类型" → "camera 유형": 영어 단어 "camera"는 유지하고 "类型"만 한국어로 번역
2. XML 태그(<xref...>)는 포맷 그대로 유지
3. 기술 용어 "Opened"와 "true"는 영어 원문 유지
4. "仅在...时可用" → "...일 때만 사용 가능합니다"로 자연스러운 기술 문서 표현 적용
5. 문장 구조와 HTML 태그의 공백/줄바꿈 원형 완전히 보존

public CameraDeviceType CameraType { get; }

DesiredAndroidCameraApiType

원하는 Android 카메라 API는 DeviceOpened 이벤트 전에 수정해야만 적용됩니다.

설정되지 않은 경우 DesiredCameraPreference에 따라 선택됩니다.

public Optional<AndroidCameraApiType> DesiredAndroidCameraApiType { get; set; }

DesiredCameraPreference

카메라 장치를 생성할 때 사용하는 선호 설정으로, 세션이 시작되기 전에 수정해야만 적용됩니다.

public Optional<CameraDevicePreference> DesiredCameraPreference { get; set; }

DesiredFocusMode

원하는 초점 모드로, DeviceOpened 이벤트 전에 수정해야 유효합니다.

주의: 하드웨어 또는 시스템 제한으로 인해 일부 기기에서는 초점 스위치가 작동하지 않을 수 있습니다. 설정하지 않으면 DesiredCameraPreference에 따라 선택됩니다.

public Optional<CameraDeviceFocusMode> DesiredFocusMode { get; set; }

DesiredSize

원하는 카메라 이미지 크기로, DeviceOpened 이벤트 발생 전에 수정해야만 적용됩니다.

SupportedSize에서 가장 가까운 크기 값을 사용합니다. 설정하지 않으면 기본값이 사용됩니다.

public Optional<Vector2Int> DesiredSize { get; set; }

DeviceCameras

새로운 프레임 소스를 생성할 때만 제공됩니다. CameraFrameStarted가 true일 때 액세스됩니다.

카메라 프레임 데이터를 제공하는 기기 카메라입니다. 카메라 프레임 데이터가 여러 카메라에서 제공되는 경우, 목록에 모든 카메라가 포함되어야 합니다.

CameraFrameStarted가 true일 때 값이 올바른지 확인하십시오.

protected override List<FrameSourceCamera> DeviceCameras { get; }

Display

새로운 프레임 소스를 생성할 때만 제공됩니다. Assemble() 과정에서만 접근됩니다.

디스플레이 시스템 정보를 제공합니다. 기본 디스플레이 정보를 얻기 위해 DefaultSystemDisplay 또는 DefaultHMDDisplay를 사용할 수 있습니다.

protected override IDisplay Display { get; }

FocusMode

초점 모드. Opened가 true일 때만 사용 가능합니다.

public CameraDeviceFocusMode FocusMode { set; }

FrameRateRange

프레임 레이트 범위. 오직 Opened가 true일 때만 사용 가능.

public Vector2 FrameRateRange { get; }

FrameRateRangeIndex

장치의 현재 프레임 속도 범위의 인덱스입니다. Opened이 true인 경우에만 사용 가능합니다.

public int FrameRateRangeIndex { get; set; }

Index

카메라 인덱스. Opened가 true일 때만 사용 가능합니다.

public int Index { get; }

IsAvailable

새로운 frame source를 생성할 때만 제공됩니다. Assemble() 과정 중에만 액세스됩니다.

현재 frame source의 사용 가능 여부입니다.

값이 null인 경우, CheckAvailability()가 호출되며 값은 Coroutine 종료 후 획득됩니다.

protected override Optional<bool> IsAvailable { get; }

IsCameraUnderControl

새로운 프레임 소스를 생성할 때만 제공됩니다. Assemble() 과정에서만 액세스됩니다.

값이 ture일 경우, 세션은 카메라의 변환(transform)을 업데이트하고 카메라 이미지를 렌더링합니다.

헤드셋 확장을 생성할 때는 false여야 합니다. 장면 내 3D 카메라를 완전히 제어해야 합니다. 특히 VST 모드에서 카메라 렌더링을 처리해야 합니다.

protected override bool IsCameraUnderControl { get; }

IsHMD

새로운 프레임 소스를 생성할 때만 제공됩니다. Assemble() 과정에서만 액세스됩니다.

현재 프레임 소스가 헤드 마운트 디스플레이(HMD)인지 여부입니다. HMD인 경우, 진단 정보가 카메라 앞의 3D 보드에 표시됩니다.

일부 frame filter는 장치에서 다르게 작동합니다.

protected override bool IsHMD { get; }

Opened

카메라가 켜져 있나요.

public bool Opened { get; }

Parameters

camera 파라미터. Opened가 true일 때만 사용할 수 있습니다.

public CameraParameters Parameters { get; set; }

Size

현재 이미지 크기입니다. Opened가 true일 때만 사용 가능합니다.

set을 사용하면 SupportedSize에서 가장 가까운 크기로 설정됩니다.

FrameRecorder 기록 중에 이미지 크기가 변경되면 기록 데이터 업데이트가 중지되며, 닫은 후 다시 기록해야 합니다.

public Vector2Int Size { get; set; }

SupportedFrameRateRange

현재 기기가 지원하는 모든 프레임 속도 범위입니다. Opened이(가) true일 때만 사용 가능합니다.

public List<Vector2> SupportedFrameRateRange { get; }

SupportedSize

현재 장치에서 지원하는 모든 이미지 크기입니다. Opened가 true일 때만 사용할 수 있습니다.

public List<Vector2Int> SupportedSize { get; }

enabled

ARSession 런타임이 비디오 스트림 데이터 수집을 시작/중단합니다. 세션이 시작된 후, MonoBehaviour.enabled가 true일 때만 수집이 시작됩니다.

public bool enabled { get; set; }

메서드

AutoFocus()

Does auto focus once. It is only available when FocusMode is Normal or Macro.

public bool AutoFocus()

Close()

기기 전원을 끕니다.

public void Close()

OnSessionStart(ARSession)

새로운 프레임 소스를 생성할 때만 제공됩니다. 이는 StartSession() 과정 중에만 접근됩니다.

이 프레임 소스가 Assembly에 조립된 경우 세션 시작을 처리합니다. 이 메서드는 지연 초기화를 위해 설계되었으며, 여기에서 AR 고유의 초기화 작업을 수행할 수 있습니다.

protected override void OnSessionStart(ARSession session)

매개 변수

session

OnSessionStop()

새로운 프레임 소스를 생성할 때만 제공됩니다. 이는 StopSession(bool) 또는 다른 세션 중지/손상 과정에서 접근됩니다.

이 프레임 소스가 Assembly에 조립된 경우 세션 중지를 처리합니다. 이 메서드를 사용하여 StartSession() 및 세션 실행 중 생성된 리소스를 파괴하고 내부 상태를 복원할 수 있습니다. 세션 파괴 전에 이 메서드의 호출이 보장됩니다. 프레임 소스가 세션보다 먼저 파괴되면 호출되지 않으며 세션은 손상됩니다.

protected override void OnSessionStop()

Open()

기기를 엽니다. Open() 및 Close()를 수동으로 호출하지 않으면, ARSession가 시작된 후 자동으로 Open()됩니다.

세션이 시작된 후에만 사용할 수 있습니다.

public void Open()

SetFlashTorch(bool)

플래시 토치 모드를 설정합니다. Opened가 true일 때만 사용 가능합니다.

public bool SetFlashTorch(bool on)

매개 변수

on

이벤트

DeviceClosed

장치 종료 이벤트.

public event Action DeviceClosed

DeviceOpened

장치 열기 이벤트, bool 값은 성공 여부를 나타냅니다.

public event Action<bool, PermissionStatus, string> DeviceOpened

DeviceStateChanged

장치 분리 또는 선점과 같은 사용할 수 없는 이벤트(Windows 전용).

public event Action<CameraState> DeviceStateChanged