기본 개념
제품 장점
시나리오

/// @brief SDK 이벤트 리스너/// @param listener: 이벤트 리스너 콜백, 주로 AI 이벤트, Tips 프롬프트 이벤트, Asset 이벤트로 구분- (void)registerSDKEventListener:(id<YTSDKEventListener> _Nullable)listener;
#pragma mark - 콜백 API/// @brief SDK 이벤트 콜백 API@protocol YTSDKEventListener <NSObject>/// @brief YTDataUpdate 콜백/// @param event NSString*형식의 콜백- (void)onYTDataEvent:(id _Nonnull)event;/// @brief AI 이벤트 콜백/// @param event dict 형식의 콜백- (void)onAIEvent:(id _Nonnull)event;/// @brief 팁 이벤트 콜백/// @param event dict 형식의 콜백- (void)onTipsEvent:(id _Nonnull)event;/// @brief 리소스 이벤트 콜백/// @param event string 형식의 콜백- (void)onAssetEvent:(id _Nonnull)event;@end
- (void)onYTDataEvent:(id _Nonnull)event;
/// @note 콜백 필드/**| 필드 | 유형 | 값 범위 | 설명 || :---- | :---- |:---- | :---- || trace_id | int | [1,INF) | 얼굴 id, 연속 비디오 스트림에서 얻은 얼굴의 얼굴 id가 동일하면 동일한 사람으로 간주할 수 있습니다 || face_256_point | float | [0,screenWidth] 또는 [0,screenHeight] | 얼굴 키포인트의 위치, 256개의 얼굴 키포인트에 대해 총 512개의 값이 있습니다. (0, 0)은 화면의 왼쪽 상단 모서리입니다 || face_256_visible | float | [0,1] | 얼굴 256 키 포인트 가시도 || out_of_screen | bool | true/false | 얼굴이 프레임 밖에 있는지 여부 || left_eye_high_vis_ratio | float | [0,1] | 왼쪽 눈의 가시성이 높은 키포인트의 비율 || right_eye_high_vis_ratio | float | [0,1] | 오른쪽 눈의 가시성이 높은 키포인트의 비율 || left_eyebrow_high_vis_ratio | float | [0,1] | 왼쪽 눈썹의 가시성이 높은 키포인트의 비율 || right_eyebrow_high_vis_ratio | float | [0,1] | 오른쪽 눈썹의 가시성이 높은 키포인트의 비율 || mouth_high_vis_ratio | float | [0,1] | 입에 대한 가시성이 높은 키포인트의 비율 |**/- (void)onYTDataEvent:(id _Nonnull)event;
void setYTDataListener(XmagicApi.XmagicYTDataListener ytDataListener)안면 인식 정보 등 데이터 콜백 설정public interface XmagicYTDataListener {void onYTDataUpdate(String data)}
{"face_info":[{"trace_id":5,"face_256_point":[180.0,112.2,...],"face_256_visible":[0.85,...],"out_of_screen":true,"left_eye_high_vis_ratio:1.0,"right_eye_high_vis_ratio":1.0,"left_eyebrow_high_vis_ratio":1.0,"right_eyebrow_high_vis_ratio":1.0,"mouth_high_vis_ratio":1.0},...]}
필드 | 유형 | 값범위 | 설명 |
trace_id | int | [1,INF) | 얼굴 ID입니다. 연속 비디오 스트림에서 얻은 얼굴의 얼굴 ID가 동일하면 동일한 사람에 속합니다. |
face_256_point | float | [0,screenWidth] 또는 [0,screenHeight] | 얼굴 키포인트의 위치입니다. 256개의 얼굴 키포인트에 대해 총 512개의 값이 있습니다. (0, 0)은 화면의 왼쪽 상단 모서리입니다. |
face_256_visible | float | [0,1] | 256개의 얼굴 키포인트의 가시성입니다. |
out_of_screen | bool | true/false | 얼굴이 프레임 밖에 있는지 여부입니다. |
left_eye_high_vis_ratio | float | [0,1] | 왼쪽 눈의 가시성이 높은 키포인트의 비율입니다. |
right_eye_high_vis_ratio | float | [0,1] | 오른쪽 눈의 가시성이 높은 키포인트의 비율입니다. |
left_eyebrow_high_vis_ratio | float | [0,1] | 왼쪽 눈썹의 가시성이 높은 키포인트의 비율입니다. |
right_eyebrow_high_vis_ratio | float | [0,1] | 오른쪽 눈썹의 가시성이 높은 키포인트의 비율입니다. |
mouth_high_vis_ratio | float | [0,1] | 입에 대한 가시성이 높은 키포인트의 비율입니다. |
매개변수 | 의미 |
XmagicApi.XmagicYTDataListener ytDataListener | 콜백 구현 클래스입니다. |
피드백