변경 로그 - Facebetter Docs

이 사이트는 SDK 2.0을 문서화합니다.

v2.0.0

2026-09-09

인증: 네이티브는 licenseToken 또는 appId + appKey를 사용합니다. Web은 licenseToken만 사용합니다. 토큰은 서버에서 받고, 브라우저 JS에 appKey를 넣지 마세요
뷰티: setSmoothing, setWhitening, setSharpening, setRosiness, setBeautySkinOnly와 스타일 프리셋
리셰이프: 26개 파라미터(FaceThin … BrowThickness), 강도 [-1.0, 1.0]
바디 리셰이프: 7개 파라미터(BodySlim … BustEnhance), 강도 [0.0, 1.0]. 선택 팩 resource_body.fbd를 addResourcePack으로 등록합니다. Pro+. 파라미터 열거형과 선택 리소스 팩을 참고하세요
메이크업: 강도 + Style(형태) + Color(틴트). 파라미터 열거형을 참고하세요
필터 / 스티커: setFilter / setSticker에 .fbd 경로 또는 바이트; 3D 스티커는 set3DSticker(resource_3d.fbd 필요, Pro+). clearFilter / clearSticker / clear3DSticker
가상 배경: 블러, 이미지 교체, 크로마키
통계: getStats() — FPS, 평균 처리 시간, 세션 길이
프레임 유형: FrameType.Image / FrameType.Video
오류 코드: 0 성공, -1 잘못된 인자, -2 미초기화, -3 라이선스, -4 미지원, -5 IO, -6 슬롯 없음, -7 처리, -8 메모리 부족
Flutter: FBEngine.create(FBEngineConfig). 실시간 영상은 네이티브 FacebetterPlugin.processTexture로 처리합니다

이벤트 (onEngineEvent / Flutter events): 0 라이선스 성공, 1 라이선스 실패, 100 초기화 완료, 101 초기화 실패.

v1.5.1

2026-08-03

fix: SetSkinOnlyBeauty가 켜진 상태에서 해상도가 다른 이미지를 처리하면 메모리 범위 초과가 발생할 수 있음(Web에서는 memory access out of bounds; 전체 페이지 새로고침으로만 복구)
improvement: 추론 성능

v1.5.0

2026-07-30

feature: 오프라인 라이선스 — 대시보드에서 다운로드하고 licenseJson으로 초기화(네트워크 불필요, 모든 플랫폼)
docs: 온라인·오프라인 인증용 라이선스 및 인증 가이드 추가

v1.4.7

2026-07-29

feature: 립스틱 및 블러셔 스타일 선택 API
improvement: 요금제 갱신 / 업그레이드가 다음 온라인 인증에서 즉시 반영
fix: Web SetSkinOnlyBeauty 크래시
fix: 이미지 처리 중 드문 크래시와 블랙 프레임

v1.4.6

2026-06-22

improvement: 얼굴이 빠르게 움직일 때 트래킹이 더 안정적

v1.4.5

2026-06-09

platform: Android 및 iOS용 Flutter SDK
docs: Flutter 문서
fix: 외부 텍스처 모드에서 스티커가 블랙 스크린을 표시할 수 있음

v1.4.4

2026-06-02

fix: 외부 텍스처 모드에서 필터와 스티커가 올바르게 적용되지 않음
fix: 외부 텍스처 모드의 iOS RGBA 텍스처 출력

v1.4.3

2026-05-04

feature: 립스틱 및 블러셔 메이크업 효과
feature: 추가 내장 스티커
fix: 일부 경우 스티커 제거 API가 반영되지 않음

v1.4.2

2026-04-23

fix: Web 라이선스 검증 엣지 케이스

v1.4.1

2026-04-12

platform: Windows SDK에 32비트와 64비트 라이브러리 모두 포함

v1.4.0

2026-03-24

feature: 피부 세그멘테이션 — 피부 영역에만 뷰티를 적용하는 SetSkinOnlyBeauty API 추가

v1.3.2

2026-03-10

improvement: 무료 버전은 10분 후 워터마크 표시
platform: Windows SDK 및 Linux SDK 지원 추가

v1.3.1

2026-03-03

web: web npm 버전을 1.3.0으로 업그레이드
improvement: 미러 인터페이스 문서 추가
deprecation: enable beauty type 인터페이스 폐기

v1.3.0

2026-02-20

improvement: 처리 성능 최적화
platform: Android Maven 저장소 의존성 지원
platform: iOS 및 macOS Demo CocoaPods 설치 지원
feature: 스타일 필터와 스티커 지원
docs: 필터 및 스티커 개발 문서 업데이트

v1.2.5

2026-01-15

improvement: 인증 및 리포팅 로직 최적화
platform: Web 인증 및 리포팅 지원

v1.2.2

2026-01-08

feature: 무료 버전 월 최대 5000회 호출
feature: 사용량 기반 과금 지원

v1.2.1

2025-12-20

feature: 워터마크 필터 추가
improvement: 네트워크 검증을 비동기 + 콜백 알림으로 변경
price: 가격 플랜 조정, Ultra 등급 추가

v1.2.0

2025-12-01

platform: 전체 플랫폼 지원(Android, iOS, macOS, Windows, Linux, Web)
feature: 가상 배경
feature: 스타일 필터
feature: 스티커 효과
feature: 온라인 인증 업그레이드
improvement: 키포인트 안정성 최적화

v1.1.3

2025-11-10

feature: 무료 버전 월 최대 5000회 호출
feature: 사용량 기반 과금

v1.1.2

2025-10-28

improvement: 키포인트 안정성 최적화
fix: 키포인트 떨림 문제 수정

v1.1.1

2025-10-15

feature: LUT 필터
feature: 얼굴 키포인트 콜백
feature: 그린스크린 매팅
feature: 앱 ID 바인딩 지원
feature: 온라인 인증 v2
feature: 멀티 프로젝트 지원

v1.1.0

2025-09-20

feature: 외부 텍스처 처리 지원
improvement: API 사용성 최적화

v1.0.6

2025-09-05

improvement: Android, iOS, macOS Demo 최적화
fix: Android 레이아웃 표시 문제 수정
platform: Android 카메라 권한 확인 추가

v1.0.5

2025-08-18

improvement: 뷰티 파라미터 조절 최적화

v1.0.4

2025-08-01

improvement: 얼굴 검출 정확도 최적화
improvement: 리소스 파일 크기 최적화

v1.0.3

2025-07-15

fix: 여러 얼굴이 감지될 때 메이크업이 한 얼굴에만 적용되던 문제 수정

v1.0.2

2025-07-01

feature: 가상 배경 지원
web: Web 중·영문 문서
web: npm 설치 지원