본문으로 건너뛰기

릴리스 노트

Klleon Ondevice SDK의 버전별 변경사항입니다.

v0.6.0 (Latest)​

릴리스일: 2026년 5월

새로운 기능​

  • Dual YUV face crops 런타임 적용 (LIPSYNC-007): ResourceManager.init()에 faceCropYuvFileName, faceCropYuvMetaFileName 파라미터 추가 (둘 다 default "" — backward-compat). 사전 추출된 face crop YUV가 있으면 warpAffine 스킵하여 추론 경로 단축.
  • ResourceManager public properties 추가: faceCropYuvBuffer, faceCropYuvPath, faceCropYuvMetaPath

변경사항​

  • VideoDecoder.decodeVideo 콜백 시그니처 확장: (rgba, faceFrame, frame, total) (이전 (rgba, frame, total)) — 내부 변경, 공개 API 영향 없음
  • 립싱크 캘리브레이션 도구 (tools/lipsync_quality/) 정비

v0.5.1​

릴리스일: 2026년 4월

변경사항​

  • 립싱크 품질 개선 (yuna/sony 아바타 캘리브레이션)
  • (sdk-docs 동기화 누락 — v0.6.0에 포함하여 정리)

v0.5.0​

릴리스일: 2026년 4월

Breaking Changes​

  • pauseVideo() / resumeVideo() / isVideoPaused() → enterStandby() / exitStandby() / isStandby()로 리네이밍
  • registerKeywords() / clearKeywords() / keywordDetected → registerWakewords() / clearWakewords() / wakewordDetected로 리네이밍

새로운 기능​

  • 대기화면(Standby) 모드: 파이프라인 전체 flush + 타이밍 재초기화로 빨리감기/ANR 방지
  • Wake-word 매칭: STT 인식 결과에서 등록된 키워드 감지 → 콜백 전달 (standby 중에만 활성)
  • setIdleTimeout() / disableIdleTimeout(): TTS_END 후 무활동 시 자동 대기화면 진입
  • isResponding: StateFlow<Boolean>: 아바타 응답 상태 추적 (PREPARING_RESPONSE ~ TTS_END)
  • STANDBY_ENTER 이벤트: 자동 대기화면 진입 시 sdkState로 발행

버그 수정​

  • VideoDecoder stop() race condition (pauseToken/stopToken 순서 역전)
  • ASYNC 모드 consumer가 pauseToken 미확인
  • AudioPlayer pause() / resume() 추가 (비디오만 멈추고 오디오 계속 재생 문제)

v0.4.0​

릴리스일: 2026년 4월

Breaking Changes​

  • play(), finish() → suspend fun으로 변경 (코루틴 내에서 호출 필요)
  • KlleonOndeviceSdk.stopping companion 프로퍼티 제거 → isStopping 인스턴스 프로퍼티로 대체

변경사항​

  • BaseElement.stop() runBlocking 제거: withTimeout(2s) + 강제 cancel 폴백
  • stopMutex 도입: stop() 동시 진입 방어 (ANR/데드락/double release 방지)
  • awaitFinish() 추가: 빠른 재진입(finish → play) 시 리소스 경합 방지
  • 미사용 bridgeJob 코드 제거

v0.3.6​

릴리스일: 2026년 4월

변경사항​

  • ResourceManager.init()에 avatarId 파라미터 추가
  • YUV buffer lifecycle 분리: 동일 아바타 재진입 시 버퍼 재사용 (0ms)
  • 다른 아바타 전환 시 3초 쿨다운 (저사양 TV SoC OOM 방어)
  • finish() 시 버퍼 유지 (resetState) + 앱 종료 시 완전 해제 (deinit)
  • onTrimMemory / onLowMemory 기반 백그라운드 메모리 자동 해제
  • init() 내부 IO 코루틴 전환 (Main 스레드 블로킹 제거)

v0.3.5​

릴리스일: 2026년 4월

변경사항​

  • RAW YUV 비디오 디코딩 파이프라인 구현 (MP4→YUV 사전 변환)
  • NV12/I420 색상 포맷 자동 감지 및 변환
  • Activity 라이프사이클 기반 네이티브 메모리 해제
  • Android 메모리 모니터링 스킬 추가

v0.3.4​

릴리스일: 2026년 3월

변경사항​

  • StyleEncoder 런타임 추론 비활성화 (.style 사전 로딩 시 모델 로드 스킵)
  • SdkInitializer.validate() 호출 복원
  • 샘플 앱 리소스 다운로드 흐름 개선

v0.3.3​

릴리스일: 2026년 3월

변경사항​

  • 사전 계산된 .style 파일 로딩 (StyleFileLoader 추가)
  • style_encoder_float32.bin 에셋 삭제 (~35MB AAR 크기 감소)
  • play() 파라미터 내부 변수화 (ttsModelUse, mmapEnabled, tokenServerUrl 제거)
  • WebSocket 음성 신호 추가 (SPEECH_START, SPEECH_END, STOP_RESPONSE_MESSAGE)
  • ResourceManager .style 파일 다운로드 지원

v0.3.2​

릴리스일: 2026년 3월

변경사항​

  • Oboe 입력 포맷 Float → I16 변경 (USB 마이크 호환성 확보)
  • I16 → Float32 런타임 변환 로직 추가
  • publish.sh STT 프로바이더별 배포 지원

v0.3.1​

릴리스일: 2026년 3월

변경사항​

  • ALWAYS_ON 음성 모드 추가 (play() 후 자동 시작, 세션 유지)
  • CONTINUOUS 모드 제거 및 dead code 정리
  • Azure STT 불필요한 START_VOICE/END_VOICE 신호 제거

v0.2.18​

릴리스일: 2026년 3월

변경사항​

  • Azure STT 토큰 서버 연동

v0.2.17​

릴리스일: 2026년 3월

새로운 기능​

  • 음성 인식 상태 알림 (STT_STATUS) 추가 — 토큰 대기/재연결/복구 완료 상태를 앱에 통지

버그 수정​

  • 일부 디바이스에서 오디오 입력 스트림 열기 실패 수정
  • play() 함수에 mmapEnabled 파라미터 추가

v0.2.16​

개선사항​

  • STT 중간 결과 (STT_PARTIAL) 지원 추가
  • SDK 배포 방식을 번들 AAR로 변경 (의존성 통합)

v0.2.15​

새로운 기능​

  • 음성 인식 개선
  • 아바타 발화 중 음성 인식 자동 일시정지

v0.2.14​

개선사항​

  • USB 마이크 호환성 개선 (MMAP 기본 비활성화)

v0.2.13​

개선사항​

  • GPU 호환성 수정

v0.2.12​

새로운 기능​

  • 자동 무음 감지
  • 저지연 오디오 입력
  • USB 마이크 자동 감지 및 전환

v0.2.11​

버그 수정​

  • 화면 회전 시 렌더링 단차(staircase artifact) 수정

v0.2.10​

새로운 기능​

  • sendStopSpeech(): 아바타 발화 중단 기능
  • sendChangeLanguage(): 대화 중 언어 변경 기능

v0.2.9​

새로운 기능​

  • 다국어 지원 (한국어/日本語/English)
  • Android TV UI 개선

v0.2.8​

새로운 기능​

  • Android TV 270도 회전 지원
  • 캐릭터별 characterId 동적 전달

v0.2.7​

개선사항​

  • USB 마이크 장치 선택 개선

v0.2.6​

새로운 기능​

  • sendChangeLanguage() API 추가
  • STT 결과 처리 개선

v0.2.5​

새로운 기능​

  • 저지연 마이크 녹음
  • USB 마이크 자동 전환
  • 무음 감지
  • WebSocket 바이너리 전송

v0.2.4​

새로운 기능​

  • play() API 변경: sdkKey, characterId, language 기반으로 전환

버그 수정​

  • Sony TV / Android 8.1 호환성 수정
  • 장시간 사용 안정성 개선

v0.2.3​

릴리스일: 2025년 12월

개선사항​

  • 보안 강화

v0.2.2​

릴리스일: 2025년 11월

개선사항​

  • AI 추론 성능 최적화

v0.2.1​

릴리스일: 2025년 10월

버그 수정​

  • 서버 연결 안정성 개선
  • WebSocket 재연결 로직 강화

v0.2.0​

릴리스일: 2025년 9월

개선사항​

  • 모델 보안 강화
  • 비디오 처리 성능 최적화
  • GPU 가속 성능 향상

v0.1.x (초기 버전)​

핵심 기능​

  • AI 기반 실시간 비디오 처리
  • 립싱크 (Lip Sync) 기능
  • WebSocket 실시간 통신

지원 환경​

  • Android 8.0+ (API 26)
  • arm64-v8a, armeabi-v7a

지원 버전​

버전상태비고
0.6.x활성 지원최신
0.5.x활성 지원
0.4.x활성 지원
0.3.x활성 지원
0.2.x유지 보수
0.1.x지원 종료2025년 Q1 종료

최신 버전 사용을 권장합니다.