Namespace easyar

클래스

APIExtend: EasyAR Sense API 및 Unity API를 확장하여 데이터 변환 등의 작업에 편의를 제공합니다.

APIKeyAccessData: API Key를 사용하는 EasyAR 클라우드 서비스 인증 데이터. 관련 데이터는 EasyAR 개발 센터(https://www.easyar.cn)에서 받을 수 있습니다.

ARAssembly: AR 컴포넌트의 어셈블리. 모든 EasyAR Sense 컴포넌트에 대한 전형적인 조립 방식을 구현합니다.

AR Foundation의 ARCore 출력을 EasyAR 입력에 연결하는 사용자 정의 frame source를 장면에 추가합니다. EasyAR Sense의 사용자 정의 카메라 기능을 통해 AR Foundation 지원을 제공합니다.

이 frame source는 ARSession에서 모션 데이터를 출력하는 모션 추적 장치입니다.

이 frame source를 사용하려면 ``AR Foundation``이 필요합니다. 공식 문서에 따라 AR Foundation을 구성해야 합니다.

ARCoreFrameSource

씬에서 ARCore 카메라 장치(easyar.ARCoreCameraDevice)를 제어하는 MonoBehaviour로, Unity 환경에서 기능 확장을 제공합니다.

이 frame source는 모션 추적 장치로, ARSession에서 모션 데이터를 출력합니다.

AREngineFrameSource

EasyAR 입력에 대한 커스텀 프레임 소스로 AR 엔진 카메라 장치의 출력을 장면에 연결합니다. Huawei AR 엔진 지원을 위해 EasyAR Sense의 커스텀 카메라 기능을 제공합니다.

이 프레임 소스는 ARSession에서 모션 데이터를 출력하는 모션 추적 장치입니다.

이 프레임 소스는 ``Huawei AR Engine Unity SDK``를 사용하지 않으며 추가할 필요가 없습니다.

ARFoundationFrameSource

EasyAR 입력에 AR Foundation 출력을 연결하는 사용자 정의 프레임 소스를 장면에 추가합니다. EasyAR Sense의 사용자 정의 카메라 기능을 통해 AR Foundation 지원을 제공합니다.

이 프레임 소스는 ARSession에서 모션 데이터를 출력하는 모션 추적 장치입니다.

이 프레임 소스를 사용하려면 ``AR Foundation``이 필요합니다. 공식 문서에 따라 AR Foundation을 구성해야 합니다.

ARKitARFoundationFrameSource

AR Foundation의 ARKit 출력을 EasyAR 입력에 연결하는 사용자 정의 프레임 소스를 장면에서 사용합니다. EasyAR Sense의 사용자 정의 카메라 기능을 통해 AR Foundation 지원을 제공합니다.

이 프레임 소스는 ARSession에서 모션 데이터를 출력하는 모션 추적 장치입니다.

이 프레임 소스를 사용하려면 ``AR Foundation``이 필요합니다. 공식 문서에 따라 AR Foundation을 구성해야 합니다.

ARKitFrameSource

장면에서 ARKit 카메라 장비(easyar.ARKitCameraDevice)를 제어하는 MonoBehaviour로, Unity 환경에서 기능을 확장합니다.

이 frame source는 ARSession에서 모션 데이터를 출력하는 모션 추적 장비입니다.

ARSession

씬에서 AR 세션을 제어하는 MonoBehaviour입니다. 세션은 ARAssembly로 조합된 컴포넌트 세트를 포함하며, 전체 라이프사이클의 데이터 흐름을 제어합니다. 이 컴포넌트는 AR의 진입점입니다. 동시에 여러 개의 활성화된 인스턴스를 허용하지 않습니다.

EasyAR 컴포넌트의 모든 기능은 StartSession() 호출 이후에야 사용 가능합니다.

Camera와 일부 AR 컴포넌트 간의 상대적인 트랜스폼(transform)은 세션에 의해 제어됩니다. 이 중 하나의 오브젝트가 CenterObject로 지정되며, 이 오브젝트는 씬에서 움직이지 않고 다른 오브젝트들이 이 CenterObject를 기준으로 움직입니다. 이 오브젝트는 CenterMode 값에 따라 선택됩니다. 더 자세한 설명은 ARSession.ARCenterMode의 설명을 참조하십시오.

ARSession.FlipOptions: 미러 렌더링 옵션.

ARSessionFactory: ARSession 팩토리.

ARSessionFactory.Resources: 해당 컴포넌트에 필요한 리소스를 생성합니다.

ActiveController

activeSelf의 활성 상태를 관리하는 MonoBehaviour입니다.

기본 전략은 다음과 같습니다: TargetController는 기본적으로 ActiveWhileTracked를 사용하고, XROriginChildController는 기본적으로 ActiveAfterFirstTracked를 사용합니다.

기본 전략을 재정의하려면 OverrideStrategy를 사용할 수 있습니다. 컨트롤을 비활성화하려면 MonoBehaviour.enabled를 false로 설정하십시오.

AppSecretAccessData: App Secret을 사용한 EasyAR 클라우드 서비스 인증 데이터. 관련 데이터는 EasyAR 개발 센터(https://www.easyar.cn)에서 확인하세요.

AssembleOptions: ARSession의 조립 옵션.

AssembleOptions.DeviceListDownload: 기기 목록 다운로드 옵션.

Buffer: Buffer는 원시 바이트 배열을 저장하며, 이미지 데이터에 접근하는 데 사용할 수 있습니다. Java API에서는 `Image`_ 에서 buffer를 가져온 후 데이터를 Java 바이트 배열로 copy할 수 있습니다. EasyAR Sense의 모든 버전에서 이미지 데이터에 접근할 수 있습니다. `Image`_ 를 참조하십시오.

BufferDictionary: 파일 경로에서 `Buffer`_로의 매핑입니다. 메모리에 저장된 여러 파일을 나타내는 데 사용됩니다.

BufferPool: BufferPool은 사용자 정의 카메라 연결 등 동일한 크기의 메모리를 반복적으로 할당해야 하는 기능에서 메모리 할당 소요 시간을 줄이기 위해 메모리 풀을 구현합니다.

CameraDeviceDisplay: 일반 카메라 디스플레이. 특별한 화면 배치 필요에 맞출 수 있도록 유니티 에디터나 PC에서 화면 회전을 시뮬레이션할 수 있습니다.

CameraDeviceFrameSource

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

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

CameraImageRenderer: 장면에서 카메라 이미지 렌더링을 제어하는 MonoBehaviour. 세션의 프레임 소스 IsCameraUnderControl가 true일 때만 유효합니다.

CameraParameters: 카메라 파라미터로는 이미지 크기, 초점 거리, 주점, 카메라 유형 및 기기 자연 방향에 대한 카메라 상대적 회전 각도가 포함됩니다.

CloudLocalizerFrameFilter: 씬에서 easyar.CloudLocalizer의 MonoBehaviour를 제어하며, Unity 환경에서 기능 확장을 제공합니다.

CloudRecognizationResponse: 인식 요청의 응답.

CloudRecognizerFrameFilter: 씬에서 easyar.CloudRecognizer의 MonoBehaviour를 제어하며, Unity 환경에서 기능 확장을 제공합니다.

DenseSpatialMapBlockController: 씬에서 easyar.DenseSpatialMap가 생성한 지도 메시 블록을 제어하는 MonoBehaviour 컴포넌트입니다.

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

DeviceFrameSourceCamera: 프레임 소스에서 카메라 프레임 데이터를 제공하는 장치 카메라입니다.

DeviceFrameSourceCamera.CameraExtrinsics: 카메라 외부 파라미터는 일반적으로 캘리브레이션된 행렬로서, 카메라가 장치/헤드의 포즈 원점에 대해 가지는 물리적 오프셋을 표현합니다.

DiagnosticsController: 현재ARSession의 진단 컨트롤러입니다. 개발 파트너처럼 활용하세요. 첫 번째로 비활성화할 컴포넌트가 아닙니다.

DiagnosticsController.MessageOutputOptions: 메시지 출력 옵션.

Display: 디스플레이 장치.

DisplayEmulator: 회전 시뮬레이터.

EasyARCameraImageRendererFeature: URP를 사용할 때 AR 기기 카메라 이미지를 렌더링하는 데 사용되는 렌더 feature입니다. 포워드 렌더러 에셋의 렌더러 feature 목록에 이 렌더 feature를 추가해야 합니다.

EasyARController: EasyAR Sense 엔진 클래스의 정적 프록시로서, 주로 Sense 초기화에 사용됩니다.

EasyARSettings: EasyAR Sense Unity Plugin의 구성 정보.

EasyARSettings.LibVariantConfig: EasyAR Sense 라이브러리 변형 구성.

EasyARSettings.Permission: 권한 설정.

EasyARSettings.TargetGizmoConfig: 타겟의Gizmos 구성.

EasyARSettings.TargetGizmoConfig.ImageTargetConfig: ImageTarget의 Gizmos 설정.

EasyARSettings.TargetGizmoConfig.ObjectTargetConfig: ObjectTarget의 Gizmos 구성.

EasyARSettings.UnityXROptions: Unity XR Framework와 관련된 구성 항목.

EasyARSettings.UnityXROptions.AutoSwitchOptions: 자동으로 Unity XR(예: AR Foundation) 오브젝트를 전환하는 옵션입니다.

EasyARSettings.UnityXROptions.AutoSwitchOptions.EditorOptions: 편집 모드 옵션.

EasyARSettings.UnityXROptions.AutoSwitchOptions.PlayerOptions: 실행 모드 옵션.

EasyARSettings.Workaround: Workaround for Unity.

EditorCameraDeviceFrameSource

에디터에서 easyar.CameraDevice의 MonoBehaviour를 제어하는 것으로, 개발 진단용으로만 사용됩니다. 일반적으로 이 frame source를 사용할 때 보이는 모든 효과는 기기에서 실행하는 것과 다릅니다. AR 효과와 무관한 애플리케이션 로직 개발에 사용할 수 있지만, AR 실행(감지, 추적, 위치 파악 등) 효과를 판단하는 근거로 삼을 수 없습니다.

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

EventDumpRecorder: 이벤트 덤프 레코더. 중요한 진단 정보를 EED 파일에 저장하는 데 사용됩니다. 이 클래스의 모든 멤버는 스레드로부터 안전합니다.

ExplicitAddressAccessData: EasyAR 클라우드 서비스 접근 주소를 기입해야 하는 인증 데이터.

ExternalDeviceFrameSource

외부 장치의 프레임 소스를 나타냅니다. 일반적으로 카메라 렌더링과 장치 추적이 모두 장치 SDK에 의해 처리되는 HMD(헤드 마운트 디스플레이)를 나타냅니다.

ExternalDeviceFrameSource의 하위 유형을 상속하여 사용자 정의 카메라를 구현할 수 있지만, ExternalDeviceFrameSource를 직접 상속할 수는 없습니다. 사용자 정의 카메라는 일반적으로 새로운 장치나 새로운 데이터 입력 방식을 표현합니다.

사용자 정의 카메라나 헤드셋에서 평가판 제품(개인용 라이선스, 평가판 XR 라이선스 또는 평가판 Mega 서비스 등)을 사용하는 경우, EasyAR Sense는 시작 후 고정된 제한된 시간 동안 응답을 중지합니다.

ExternalDeviceMotionFrameSource

모션 추적 기능을 갖춘 외부 장치의 프레임 소스를 나타냅니다. 일반적으로 카메라 렌더링과 장치 추적이 모두 장치 SDK에 의해 처리되는 헤드 마운트 디바이스를 의미합니다.

이 프레임 소스는 ARSession에서 모션 데이터를 출력하는 모션 추적 장치입니다.

이를 상속하여 헤드 마운트 디스플레이와 같은 장치 입력을 구현할 수 있지만, 모션 추적 기능은 직접 완료해야 합니다. EasyAR의 모션 추적은 외부 장치에서 직접 사용할 수 없습니다. 하드웨어나 다른 곳에서 이미지와 pose 데이터를 직접 획득하여 EasyAR로 입력해야 합니다. EasyAR은 이러한 데이터의 획득 능력을 제공하지 않지만, 데이터가 EasyAR에 입력된 후 EasyAR 기능을 실행하는 능력은 제공합니다.

사용자 정의 카메라나 헤드 마운트 디스플레이에서 평가판 제품(개인용 라이선스, 평가판 XR 라이선스 또는 평가판 Mega 서비스 등)을 사용할 때, EasyAR Sense는 시작 후 고정된 제한된 시간 이후 응답을 중지합니다.

ExternalDeviceRotationFrameSource

3DOF 회전 추적 기능을 갖춘 외부 장치의 프레임 소스를 나타냅니다. 일반적으로 카메라 렌더링과 장치 추적이 모두 장치 SDK에 의해 완료되는 헤드 마운트 장치를 의미합니다.

이 프레임 소스는 ARSession에서 회전 데이터를 출력하는 3DOF 회전 추적 장치입니다.

헤드 마운트 디스플레이와 같은 장치 입력을 구현하기 위해 이를 상속할 수 있지만, 추적 기능을 직접 완료해야 합니다. EasyAR의 3DOF 회전 추적은 외부 장치에서 직접 사용할 수 없습니다. 하드웨어나 다른 소스에서 이미지와 회전 데이터를 직접 획득하여 EasyAR에 입력해야 합니다. EasyAR은 이러한 데이터의 획득 능력을 제공하지 않지만, 데이터가 입력된 후 EasyAR 기능을 실행하는 능력은 제공합니다.

사용자 정의 카메라 또는 헤드 마운트 디스플레이에서 평가판 제품(개인용 라이선스, 평가판 XR 라이선스 또는 평가판 Mega 서비스 등)을 사용할 때, EasyAR Sense는 시작 후 고정된 제한 시간 이후 응답을 중지합니다.

ExternalFrameSource

외부 프레임 소스는 EasyAR Sense에 내장되지 않은 프레임 소스를 나타냅니다. AR Engine, AR Foundation 또는 헤드셋을 지원하는 데 사용되며, 사용자 정의 프레임 소스를 정의하는 데에도 사용할 수 있습니다.

ExternalFrameSource의 일부 하위 유형을 상속하여 사용자 정의 카메라를 구현할 수 있지만, ExternalFrameSource를 직접 상속할 수는 없습니다. 사용자 정의 카메라는 일반적으로 새로운 장치 또는 새로운 데이터 입력 방식을 나타냅니다.

사용자 정의 카메라 또는 헤드셋에서 평가판 제품(개인용 라이선스, 평가판 XR 라이선스 또는 평가판 Mega 서비스 등)을 사용하는 경우, EasyAR Sense는 시작 후 고정된 제한 시간 동안 응답을 중지합니다.

ExternalImageStreamFrameSource

이미지 스트림 입력만 받는 외부 프레임 소스.

이 프레임 소스는 모션 추적 장비가 아니며, ARSession에서 모션 데이터를 출력하지 않습니다.

이를 상속하여 이미지 입력만 있는 사용자 정의 카메라를 구현할 수 있습니다. 헤드 마운트 디스플레이 입력을 구현하는 데는 사용할 수 없습니다. 하드웨어나 다른 곳(예: USB로 연결된 Android 카메라)에서 이미지를 직접 가져와 EasyAR에 입력해야 합니다. EasyAR은 이러한 데이터를 획득하는 기능을 제공하지 않지만, 데이터를 EasyAR에 입력한 후 EasyAR 기능을 실행하는 능력은 제공합니다.

사용자 정의 카메라나 헤드 마운트 디스플레이에서 평가판 제품(개인용 라이선스, 평가판 XR 라이선스 또는 평가판 Mega 서비스 등)을 사용할 때, EasyAR Sense는 시작 후 고정된 제한 시간이 지나면 응답을 중지합니다.

FixedAddressAPIKeyAccessData: API Key를 사용하는 EasyAR 클라우드 서비스 인증 데이터. 관련 데이터는 EasyAR 개발 센터(https://www.easyar.cn)에서 받을 수 있습니다.

FrameFilter: 프레임 필터는 프레임 입력 데이터를 사용하여 실행되는 EasyAR 기능을 나타냅니다.

FramePlayer

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

이 컴포넌트는 FrameSource가 FramePlayer로 설정되었거나, 에디터에서 DiagnosticsController 인스펙터의 'Session Validation Tool'에서 'Frame Player'DiagnosticsController를 선택했을 때 사용됩니다.

FrameRecorder

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

이것은 Assembly에 자동으로 조립됩니다.

enabled는 녹화 시작 및 종료를 제어할 수 있습니다.

FrameRecorder.RecordFinishEvent: 녹화 종료 이벤트. 녹화 중 오류 발생 시 콜백 매개변수는 false입니다.

FrameRecorder.RecordStartEvent: 녹화 시작 이벤트. 콜백 매개변수는 녹화 파일명입니다.

FrameRecorder.RecordingConfiguration: 녹화 구성

FrameRecorder.RecordingConfiguration.FilePathInfo: 파일 경로 정보. Type가 PersistentDataPath인 경우 녹화된 파일 경로는 Path.Combine(Application.persistentDataPath, FolderPath, Name + extension)이며, Type가 Absolute인 경우에는 Path.Combine(FolderPath, Name + extension)입니다. 여기서 extension은 Format에 의해 결정됩니다.

FrameSource

프레임 소스는 프레임 입력 데이터의 데이터 소스를 나타내며, 이미지 데이터 또는 모션 데이터를 함께 제공합니다.

사용자 정의 카메라를 구현하기 위해 FrameSource의 일부 하위 유형을 상속할 수 있지만, FrameSource를 직접 상속할 수는 없습니다. 사용자 정의 카메라는 일반적으로 새로운 장치나 새로운 데이터 입력 방식을 표현합니다.

사용자 정의 카메라나 헤드셋에서 평가판 제품(개인용 라이선스, 평가판 XR 라이선스 또는 평가판 Mega 서비스 등)을 사용할 때, EasyAR Sense는 시작 후 고정된 제한 시간 후에 응답을 중지합니다.

FrameSourceCamera: Frame source에서 카메라 프레임 데이터를 제공하는 카메라.

Image

Image는 이미지 데이터를 저장하며, 메모리 내 이미지를 나타냅니다. Image는 원시 데이터에 대한 접근을 바이트 배열 방식으로 제공하며, width/height 등의 정보에 접근하는 인터페이스도 제공합니다. EasyAR Sense의 모든 버전에서 이미지 데이터에 접근할 수 있습니다.

 iOS에서는 다음과 같이 접근할 수 있습니다
 ::

     #import <easyar/buffer.oc.h>
     #import <easyar/image.oc.h>

     easyar_OutputFrame * outputFrame = [outputFrameBuffer peek];
     if (outputFrame != nil) {
         easyar_Image * i = [[outputFrame inputFrame] image];
         easyar_Buffer * b = [i buffer];
         char * bytes = calloc([b size], 1);
         memcpy(bytes, [b data], [b size]);
         // use bytes here
         free(bytes);
     }

 Android에서는,
 ::

     import cn.easyar.*;

     OutputFrame outputFrame = outputFrameBuffer.peek();
     if (outputFrame != null) {
         InputFrame inputFrame = outputFrame.inputFrame();
         Image i = inputFrame.image();
         Buffer b = i.buffer();
         byte[] bytes = new byte[b.size()];
         b.copyToByteArray(0, bytes, 0, bytes.length);
         // use bytes here
         b.dispose();
         i.dispose();
         inputFrame.dispose();
         outputFrame.dispose();
     }
 </p>

ImageHelper: 이미지 도움말 클래스.

ImageMaterial: Image 렌더링에 사용되는 머티리얼.

ImageTarget: ImageTarget은 평면 이미지의 타겟을 나타내며, `ImageTracker`_에 의해 추적될 수 있습니다. ImageTarget 내의 값들은 읽기 전에 먼저 create... 등의 메서드를 통해 채워져야 합니다. 이후 `ImageTracker.loadTarget`_을 통해 `ImageTracker`_에 성공적으로 로드된 후에는 `ImageTracker`_에 의해 감지 및 추적될 수 있습니다.

ImageTargetController

씬에서 ImageTarget를 제어하는 MonoBehaviour로, Unity 환경에서 기능 확장을 제공합니다. 로드가 성공한 후 Target를 사용하여 target 데이터에 접근할 수 있습니다.

target 데이터는 별도로 로드되며, 로드는 세션이 성공적으로 시작된 후 발생합니다. 생명주기 동안 한 번만 완전히 로드되며, 로딩이 중간에 중단되면 다음 세션 시작 시 다시 로드됩니다.

ImageTargetController.ImageFileSourceData: target의 이미지 데이터를 생성합니다.

ImageTargetController.SourceData: target의 데이터를 생성합니다.

ImageTargetController.TargetDataFileSourceData: 대상의 대상 데이터를 생성합니다. 대상 이름과 크기는 etd 파일에 정의되어 있습니다.

ImageTargetController.TargetSourceData: target의 ImageTarget 데이터를 생성.

ImageTargetController.Texture2DSourceData: 타겟의 Texture2D 데이터를 생성합니다.

ImageTargetParameters: ImageTargetParameters는 `ImageTarget`_ 생성에 필요한 파라미터를 나타냅니다.

ImageTrackerFrameFilter: 씬에서 easyar.ImageTracker의 MonoBehaviour을 제어하며, Unity 환경에서 기능 확장을 제공합니다.

InertialCameraDeviceFrameSource

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

이 프레임 소스는 5DOF(회전+수평 변위) 추적 장치로, ARSession 내에서 모션 데이터를 출력합니다.

InputFrame: 입력 프레임. 이미지, 카메라 파라미터, 타임스탬프, world 좌표계에 대한 카메라의 변환(transform), 트래킹 상태를 포함합니다. 카메라 파라미터, 타임스탬프, world 좌표계에 대한 카메라의 변환(transform), 트래킹 상태는 모두 선택 사항이지만, 특정 알고리즘 컴포넌트는 입력에 특정 요구사항을 가질 수 있습니다.

MegaLandmarkFilterResponse: Mega Landmark filter 요청에 대한 응답.

MegaLandmarkFilterWrapper: Mega Landmark VPS 클라우드 위치 필터링 기능.

MegaLocalizationResponse: Mega 위치 확인 요청에 대한 응답입니다.

MegaRequestTimeParameters: Mega 요청 시간 매개변수.

MegaTrackerFrameFilter: 씬에서 easyar.MegaTracker의 MonoBehaviour를 제어하며, Unity 환경에서 기능 확장을 제공합니다.

MotionInputData: 운동 입력 데이터. 시간 스탬프, 세계 좌표계 기준의 변환, 그리고 추적 상태를 포함합니다.

MotionTrackerFrameSource

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

이 프레임 소스는 모션 추적 장치로, ARSession에서 모션 데이터를 출력합니다.

ObjectTarget: ObjectTarget는 3D 객체 타겟을 나타내며, `ObjectTracker`_에 의해 추적될 수 있습니다. ObjectTarget의 크기는 `obj` 파일에 의해 결정됩니다. `scale`을 수정하여 크기를 변경할 수 있습니다. `scale`의 기본값은 1입니다. ObjectTarget는 `ObjectTracker.loadTarget`_를 통해 `ObjectTracker`_에 성공적으로 로드된 후 `ObjectTracker`_에 의해 감지 및 추적될 수 있습니다.

ObjectTargetController

씬에서 ObjectTarget를 제어하는 MonoBehaviour로, Unity 환경에서 기능 확장을 제공합니다. 로드가 성공하면 Target를 사용하여 대상 데이터에 접근할 수 있습니다.

대상 데이터는 별도로 로드되며, 로드는 세션이 성공적으로 시작된 후 발생합니다. 수명 주기 동안 완전히 한 번만 로드되며, 일부 로드된 상태에서 세션이 중지되면 다음 세션 시작 시 다시 로드됩니다.

ObjectTargetController.ObjFileSourceData: 생성 target의 obj 파일 데이터.

ObjectTargetController.SourceData: target의 데이터를 생성합니다.

ObjectTargetController.TargetSourceData: target의 ObjectTarget 데이터를 생성합니다.

ObjectTargetParameters: ObjectTargetParameters는 `ObjectTarget`_ 생성에 필요한 매개변수를 나타냅니다.

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

PicoFrameSource

EasyAR 입력에 대한 커스텀 프레임 소스로 Pico의 출력을 장면에 연결합니다. EasyAR Sense의 사용자 정의 카메라 기능을 통해 Pico 지원을 제공합니다.

이 프레임 소스는 ARSession에서 모션 데이터를 출력하는 모션 추적 장치입니다.

이 프레임 소스를 사용하기 위해서는 ``PICO Unity Integration SDK``가 필요합니다. 공식 문서에 따라 PICO Unity Integration SDK를 구성해야 합니다.

PoseUtility

RefBase

RokidFrameSource

EasyAR 입력에 대한 사용자 정의 프레임 소스로 Rokid 출력을 장면에 연결합니다. EasyAR Sense의 사용자 정의 카메라 기능을 통해 Rokid 지원을 제공합니다.

이 프레임 소스는 ARSession에서 모션 데이터를 출력하는 모션 추적 장치입니다.

이 프레임 소스를 사용하려면 ``Rokid Unity OpenXR Plugin (com.rokid.openxr)``가 필요합니다. 공식 문서에 따라 Rokid Unity OpenXR Plugin을 설정해야 합니다.

SenseLibrary: EasyAR Sense 라이브러리 정보를 가져오는 도구입니다.

ServiceAccessData: EasyAR 클라우드 서비스 인증 데이터.

SessionReport

Session 보고서. 컴포넌트 가용성 또는 세션 손실 원인 등을 조회하는 데 사용됩니다.

(설명)

"Session 보고서"는 원문의 "Session report"를 직역하여 영어 단어를 그대로 유지하고 한글 설명을 덧붙였습니다.
"컴포넌트 가용성(component availability)", "세션 손실(session loss)"은 기술 용어로 영어 단어를 그대로 사용하며 띄어쓰기 없이 번역했습니다.
"조회하는 데 사용됩니다"는 "used to query"의 자연스러운 한국어 표현입니다.
HTML 태그(
)와 문장 구조를 원본 그대로 유지했습니다.
모든 영어 단어(Component, Session 등)는 번역하지 않고 원문대로 표기했습니다.

SessionReport.AvailabilityReport: 사용성 보고서.

SessionReport.AvailabilityReport.DeviceListDownloadResult: 장비 목록 다운로드 결과.

SessionReport.AvailabilityReport.Item: 사용성 프로젝트.

SessionReport.SessionBrokenException: Session 손상 구체적 예외.

SparseSpatialMapBuildTargetController: 씬에서 easyar.SparseSpatialMap에 의해 생성된 지도를 제어하는 MonoBehaviour입니다.

SparseSpatialMapBuilderFrameFilter: 씬에서 easyar.SparseSpatialMap를 제어하는 MonoBehaviour로, easyar.SparseSpatialMap의 매핑 기능을 제공합니다.

SparseSpatialMapController: 씬 내에서 easyar.SparseSpatialMap에 의해 추적되는 맵의 MonoBehaviour입니다.

SparseSpatialMapController.MapManagerSourceData: MapManager의 맵 생성 소스.

SparseSpatialMapController.SourceData: target의 데이터를 생성합니다.

SparseSpatialMapController.SparseSpatialMapInfo: 희소 지도 정보.

SparseSpatialMapPointCloudRenderer: 희소 공간 맵 포인트 클라우드를 입자로 렌더링합니다.

SparseSpatialMapPointCloudRenderer.PointCloudParticleParameter: 포인트 클라우드 입자의 렌더링 파라미터.

SparseSpatialMapTrackerFrameFilter: 장면에서 easyar.SparseSpatialMap를 제어하는 MonoBehaviour으로, easyar.SparseSpatialMap의 위치 추적 기능을 제공합니다.

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

SurfaceTargetController: 씬에서 surface target을 제어하는 MonoBehaviour입니다. surface target은 표면 추적에서 카메라 이동의 상대적 노드를 나타내는 가상의 노드입니다.

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

Target: Target은 EasyAR에서 `ImageTracker`_ 또는 다른 알고리즘으로 추적 가능한 모든 대상의 기본 클래스입니다.

TargetController: 씬에서 추적 대상을 제어하는 MonoBehaviour로, Unity 환경에서 기능 확장을 제공합니다.

ThreeDofCameraDeviceFrameSource

씬에서 3DOF 카메라 장치(ThreeDofCameraDeviceFrameSource)를 제어하는 MonoBehaviour로, Unity 환경에서 기능 확장을 제공합니다.

이 프레임 소스는 3DOF 회전 추적 장치로, ARSession 내에서 회전 데이터를 출력합니다.

TokenAccessData: 토큰을 사용하는 EasyAR 클라우드 서비스 인증 데이터. 자세한 데이터는 EasyAR 개발 센터(https://www.easyar.cn)를 방문하세요.

UnityPackage: 패키지 정보를 가져오는 도구입니다.

VideoRecorder

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

사용자는 비디오 녹화 내용을 완전히 제어할 수 있으며, 화면 녹화 기능은 화면이나 카메라 출력을 조용히 녹화하지 않습니다. 녹화된 비디오 데이터는 RecordFrame(RenderTexture)를 통해 지속적으로 전달되어야 합니다.

참고: 비-엔터프라이즈 버전 Sense에서만 사용 가능하며, Android GLES2/3 환경에서 멀티스레드 렌더링이 비활성화된 경우에만 사용할 수 있습니다.

VideoRecorder.AudioProfiles: 오디오 구성.

VideoRecorder.VideoProfiles: 비디오 설정입니다.

VisionOSARKitFrameSource

VisionOS ARKit 카메라 장치(easyar.VisionOSARKitCameraDevice)를 장면에서 제어하는 MonoBehaviour로, Unity 환경에서 기능 확장을 제공합니다.

이 프레임 소스는 ARSession에서 모션 데이터를 출력하는 모션 추적 장치입니다.

사용자 정의 카메라 또는 헤드셋에서 평가판 제품(personal-edition license, 평가판 XR license 또는 평가판 Mega 서비스 등)을 사용할 경우, EasyAR Sense는 시작 후 고정된 제한 시간 이후에 응답을 중지합니다.

XREALFrameSource

씬에서 XREAL 카메라 장치(easyar.XREALCameraDevice)를 제어하는 MonoBehaviour로, Unity 환경에서 기능 확장을 제공합니다.

이 프레임 소스는 모션 추적 장치로, ARSession에서 모션 데이터를 출력합니다.

사용자 정의 카메라 또는 헤드셋에서 평가판 제품(개인용 라이선스, 평가판 XR 라이선스 또는 평가판 Mega 서비스 등)을 사용할 때, EasyAR Sense는 시작 후 고정된 제한 시간이 지나면 응답을 중지합니다.

XROriginChildController

씬에서 제어가 필요한 XROrigin 하위 오브젝트의 루트 노드를 담당하는 MonoBehaviour입니다. 씬에 이 노드를 수동으로 설정하지 않으면 필요한 시점에 자동으로 생성됩니다.

XROrigin은 모션 추적 시스템에서 카메라 이동의 기준점이 되는 가상의 노드이며, 자동으로 선택되거나 생성됩니다. Unity XR 프레임워크의 XROrigin이 존재하면 해당 노드가 선택됩니다.

구조체

ARSessionFactory.FrameSourceSortMethod: Frame source의 정렬 방법.

BlockInfo

조밀 재구축으로 얻은 모델은 삼각형 메쉬로 표현되며, 이를 메쉬(mesh)라고 합니다. 메쉬는 자주 업데이트되기 때문에 효율성을 보장하기 위해 전체 재구축 모델의 메쉬는 매우 많은 메쉬 블록(mesh block)으로 분할되어 있습니다. 하나의 메쉬 블록은 한 변의 길이가 약 1미터인 정육면체로 구성되며, 버텍스(vertex)와 인덱스(index) 등의 요소를 포함합니다.

 BlockInfo는 하나의 메쉬 블록 내용을 설명하는 데 사용됩니다. 여기서 (x,y,z)는 메쉬 블록의 인덱스이며, (x,y,z)에 각 메쉬 블록의 물리적 크기를 곱하면 이 메쉬 블록의 원점이 월드 좌표계에서의 좌표를 얻을 수 있습니다. 렌더링에 필요한 시간을 절약하기 위해 표시해야 할 부분을 사전에 필터링하기 위해 메쉬 블록이 월드에서의 위치를 사용할 수 있습니다.
 </p>

Matrix33F: 3차 정방행렬. 데이터의 배열 방식은 row-major입니다.

Matrix44F: 4차 정방행렬. 데이터 배열 방식은 row-major입니다.

Optional<T>

ProximityLocationResult

근접 위치 판독값.

 x, y, z 단위는 미터. 원점은 지도 타일 원점. y축 위쪽.
 accuracy 단위는 미터.
 timestamp, validTime 단위는 초.
 is2d는 y를 사용하지 않음을 나타냅니다.
 </p>

Unit

Vec2F: 2차원 float 벡터.

Vec2I: 2차원 int 벡터.

Vec3F: 3차원 float 벡터.

Vec4F: 4차원 float 벡터.

인터페이스

IDisplay: 디스플레이 장치 인터페이스.

열거형

ARCoreCameraDeviceFocusMode

AREngineCameraDeviceFocusMode

ARKitCameraDeviceFocusMode

ARSession.ARCenterMode

AR 센터 모드.

*참고: EasyAR Sense Unity Plugin에는 총 네 가지 센터 모드가 있습니다. AR Foundation과 같은 다른 AR 프레임워크에서는 유사한 개념이 존재하지 않을 수 있으며, 일반적으로 해당 프레임워크 내 물체 간 상대적 관계 동작은 여기의 *SessionOrigin* 모드와 일치합니다.*

Camera와 일부 AR 컴포넌트 간 상대적인 transform은 세션에 의해 제어됩니다. 이 중 하나의 물체가 CenterObject로 지정되며, 이 물체는 장면 내에서 움직이지 않고 다른 물체들이 이 CenterObject를 기준으로 움직입니다. 이 물체는 CenterMode 값에 따라 선택됩니다.

CenterObject는 Unity 공간에서 움직이지 않는 물체 또는 그 물체의 부모 노드를 나타냅니다. 이는 Origin, Camera 또는 특정 `target`이 될 수 있습니다. `Target`은 TargetController 또는 BlockRootController 컴포넌트를 포함하는 물체입니다. 희소 공간 맵과 EasyAR Mega를 사용할 때, 실제 중심 GameObject는 루트 노드 아래 구체적으로 위치가 파악된 map 또는 block 물체이며, CenterObject는 이 물체의 부모 노드입니다.

FirstTarget 또는 SpecificTarget 모드에서, `target`이 특정 프레임에서 인식되지 않거나 추적이 끊어졌을 때, CenterObject는 다른 `target`으로 변경될 수 있습니다. 만약 프레임 내에서 `target`을 찾을 수 없으면, CenterObject는 사용 가능한 순서대로 SessionOrigin 및 Camera 중 첫 번째로 사용 가능한 모드의 중심으로 되돌아가게 됩니다.

`Target`과 Camera의 상대적 위치 관계는 현재 세션에 의해 제어됩니다. Origin과 Camera의 상대적 위치 관계는, IsCameraUnderControl이 true일 때 현재 세션에 의해 제어되지만, IsCameraUnderControl이 false일 때는 현재 세션의 제어를 받지 않으며, 일반적으로 AR Foundation과 같은 다른 AR 프레임워크에 의해 제어됩니다.

ARSession.ARHorizontalFlipMode

수평 미러 렌더링 모드.

수평 반전 상태에서 카메라 이미지는 미러링되어 표시되며, 객체 추적이 정상적으로 작동하도록 3D 객체 렌더링에도 영향을 미칩니다. 따라서 두 가지 다른 방식을 제공합니다. 수평 반전은 객체 인식(예: 이미지 추적이나 객체 추적) 알고리즘에서만 작동할 수 있습니다.

ARSession.SessionState: Session의 상태.

ARSessionFactory.ARSessionPreset: ARSession 프리셋.

ARSessionFactory.FrameSourceSortMethod.ARCoreSortMethod: ARCore/ARCoreARFoundation 프레임 소스의 정렬 방법.

ARSessionFactory.FrameSourceSortMethod.ARKitSortMethod: ARKit/ARKitARFoundation 프레임 소스의 정렬 방법.

ARSessionFactory.FrameSourceSortMethod.MotionTrackerSortMethod: EasyAR 모션 트래커/System SLAM (ARCore, ARKit, AREngine) 프레임 소스의 정렬 방법.

ActiveController.Strategy

activeSelf의 제어 전략.

（翻译说明：严格遵循用户要求）

保留HTML标签结构不变
专有名词"u:UnityEngine.GameObject.activeSelf"保持原文
连字符"u%3a"处理为"u:"（%3a是URL编码的冒号）
仅将中文部分"的控制策略"翻译为"의 제어 전략"
未添加任何额外内容或格式变更

AndroidCameraApiType

AssembleOptions.FrameFilterSelection: FrameFilter의 선택 전략을 선택합니다.

AssembleOptions.FrameSourceSelection: FrameSource 선택 전략을 선택합니다.

AxisSystemType: 좌표축 시스템 유형.

CameraDeviceDisplay.DisplayMode: 표시 모드.

CameraDeviceFocusMode

CameraDeviceFrameSource.CameraDeviceOpenMethod: easyar.CameraDevice 켜는 방법.

CameraDevicePreference

CameraDeviceType: 카메라 장치 유형.

CameraModelType: 카메라 모델 유형.

CameraState

CameraTransformType: 카메라 변환 유형.

CloudRecognizationStatus

CloudRecognizerFrameFilter.ServiceAccessSourceType: 서비스 접근 데이터 소스 유형.

DiagnosticsController.DeveloperModeSwitchType: 개발자 모드 스위치 유형.

DiagnosticsController.MessageOutputMode: 메시지 출력 모드입니다.

DiagnosticsController.SessionDumpOutputMode: 세션 상태 덤프 출력 모드.

DisplayEmulator.RotationMode: 회전 모드.

EasyARSettings.ARCoreType: ARCore SDK 구성.

EasyARSettings.AREngineType: AREngine SDK 구성.

EasyARSettings.LibVariantConfig.AndroidVariant: EasyAR Sense Android 라이브러리 변형.

EasyARSettings.LibVariantConfig.IOSVariant: EasyAR Sense iOS 라이브러리 변종.

ExternalDeviceFrameSource.DeviceOriginType

디바이스 오리진 타입.

세션 오리진(session origin)은 SessionOrigin 센터 모드에서의 변환(transform) 기준점을 설정하며, 다른 센터 모드에서 camera-origin 쌍을 동시에 변환하는 데 사용됩니다. Unity XR 프레임워크 기반으로 SDK를 설계한 경우 XR.CoreUtils.XROrigin에 익숙할 것입니다. 오리진(Origin)은 XR.CoreUtils.XROrigin과 유사한 개념으로, 렌더링 카메라는 이의 자식 노드입니다. 사용자는 camera-origin 쌍에 의해 정의된 로컬 운동 관계를 손실하지 않고 장면(scene) 내에서 origin을 이동시킬 수 있습니다. EasyAR은 타겟(target) 센터 모드를 처리하기 위해 camera-origin 쌍을 사용하며, 이는 전체 지구의 실제 세계 좌표계를 정의하는 Mega를 실행할 때 특히 유용합니다. Mega에서 camera-origin 쌍은 일반적으로 특정 시작점을 기준으로 한 VIO(Virtual Inertial Odometry) 좌표계를 정의합니다.

FrameRecorder.InternalFormat: 내부 데이터 형식.

FrameRecorder.RecorderStatus: 녹화 상태.

ImageTrackerMode

InertialCameraDeviceFocusMode

LocalizationMode

LogLevel

MegaApiType: MEGA API 유형.

MegaInputFrameLevel: Mega 기능을 사용할 때 입력 프레임의 등가 CameraTransformType의 등가 자유도.

MegaLandmarkFilterStatus

MegaLocationInputMode: Mega 위치 입력 모드.

MegaServiceAccessSourceType: Mega 서비스 접근 데이터 소스 유형.

MegaTrackerLocalizationStatus

MotionTrackerCameraDeviceFPS

MotionTrackerCameraDeviceFocusMode

MotionTrackerCameraDeviceQualityLevel

MotionTrackerCameraDeviceResolution

MotionTrackerCameraDeviceTrackingMode

MotionTrackingStatus: 장치 운동 추적의 품질을 설명합니다.

OptionalTag

PathType: 경로 유형.

PermissionStatus

PixelFormat: PixelFormat는 이미지 픽셀 형식을 나타냅니다. 모든 형식의 픽셀 방향은 좌측에서 우측으로, 상단에서 하단으로 진행됩니다.

SessionReport.AvailabilityReport.AvailabilityStatus: 가용성 상태.

SessionReport.AvailabilityReport.DeviceListDownloadStatus: 다운로드 목록의 상태.

SessionReport.AvailabilityReport.DeviceListDownloadType: 다운로드 목록의 컴포넌트 유형.

SessionReport.SessionBrokenReason: Session 손상 원인.

SparseSpatialMapWorkerFrameFilter.ServiceAccessSourceType: 서비스 접근 데이터 소스 유형.

StorageType: StorageType은 이미지, json 파일, 비디오 또는 기타 파일의 저장 위치를 의미합니다. StorageType은 파일이 저장되는 루트 디렉터리를 지정하며, 모든 관련 인터페이스에서 이 루트 디렉터리를 기준으로 한 상대 경로를 사용할 수 있습니다.

ThreeDofCameraDeviceFocusMode

VideoRecorder.RecordProfile: 비디오 설정입니다.

VideoRecorder.RecordZoomMode: 비디오 확대/축소 모드.

VideoRecorder.VideoOrientation: 화면 녹화 방향.

VideoRecorder.VideoSize: 동영상 크기.

WritablePathType: 파일 출력 경로 유형.

Table of Contents

Namespace easyar

클래스

구조체

인터페이스

열거형