Skip to main content
SDK 2.0.0. 인증: 인증 및 라이선스. 열거형 값: 파라미터 열거형.

설치

엔진 만들기

Web의 EngineConfig에는 이 필드만 있습니다. 설정 객체에 appId / appKey는 없습니다. SDK는 init() 동안 런타임 파일을 로드합니다. 엔진을 위해 사이트 루트에 resource.fbd를 두지 마세요. 선택적 다운로드 진행률: init({ onProgress }). 엔진은 토큰을 fetch하지 않습니다. Web은 오프라인 .lic를 지원하지 않습니다.
로드 / 인증 로그를 보려면 init() 전에 setLogConfig를 호출하세요. 브라우저에서는 파일 로깅을 지원하지 않습니다(fileEnabled는 무시됨).

피부 뷰티

강도 범위 [0.0, 1.0]. 0이면 효과가 꺼집니다.
setBeautySkinOnly(true)는 스무딩 / 미백 / 샤프닝 / 혈색을 감지된 피부에만 제한합니다. 옷과 배경은 그대로입니다.
스타일 열거형: 파라미터 열거형.

페이스 리셰이프

범위는 **[-1.0, 1.0]**입니다. 0은 꺼짐입니다. 양수와 음수는 반대 방향입니다(예: FaceThin: 슬림 / 볼 볼륨). 전체 목록: 파라미터 열거형.

바디 리셰이프

범위는 **[0.0, 1.0]**입니다. 0은 꺼짐입니다. init() 이후 resource_body.fbd를 가져와 addResourcePack하세요. 전체 목록: 파라미터 열거형. 선택 리소스 팩.

메이크업

강도, 형태, 색상은 별도 setter입니다. 강도는 [0.0, 1.0]입니다. 프리셋: 파라미터 열거형.

필터와 스티커

.fbd URL 또는 메모리의 Uint8Array를 setter에 직접 전달하세요.
3D 스티커에는 선택 팩 resource_3d.fbd가 필요합니다(Web SDK에 없음). 선택 리소스 팩을 참고하세요. init() 이후 바이트를 가져와 등록하세요.

가상 배경과 크로마키

크로마키는 마스크만 바꿉니다. 채우기는 여전히 setVirtualBackgroundBlur 또는 setVirtualBackground입니다. 블러와 이미지 교체는 상호 배타적입니다.

콜백

랜드마크가 필요하지 않으면 onFaceLandmarks를 생략하세요. 켜면 매 프레임 얼굴 검출이 실행됩니다.

프레임 처리

processImage를 권장합니다. ImageData를 동기로 반환합니다.
inputImageData, HTMLImageElement, HTMLCanvasElement, HTMLVideoElement, 또는 Uint8ClampedArray(이때 width / height 필요)일 수 있습니다.
  • FrameType.Video — 라이브 카메라 / 스트리밍(시간적 스무딩)
  • FrameType.Image — 정지 사진
processTexture(textureHandle, width, height, stride, frameType, mirrorMode)는 커스텀 GPU 텍스처 입력용입니다. 이 경로에서는 미러가 적용되지 않습니다. 일반적인 웹 앱은 processImage를 사용해야 합니다.

통계

파괴

페이지 언로드 또는 React/Vue 컴포넌트 unmount 시 호출하세요. TRTC / Agora / LiveKit: 서드파티 연동.

관련 문서