릴리즈 노트
3.0.18
Release Date: 2026-07-09
Fixed
- 라이브 시청 중 채팅창 미노출 현상 수정
- 변경 사유: 라이브 방송 시청 중 채팅창이 화면에 표시되지 않는 버그 해결
- 발생 버전: v3.0.14 이상 ~ v3.0.17 이하
- 앱 변경 여부: 없음
3.0.17
Release Date: 2026-06-09
Fixed
- 짧은 인트로 재생 후 본영상 전환 시 -8615 에러 수정
- 재현 경로 : 본영상의 프리로드(Pre-load)가 완료되지 않은 상태에서 2초 내외의 짧은 인트로 영상 재생이 끝나고, 본영상 재생 시점으로 전환될 때 -8615 에러가 발생함
- 변경 사유: -8615 에러 수정
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.16
Release Date: 2026-05-27
Added APIs
- 다중 오디오 트랙 조회 기능 추가
// MediaPlayer Class
public void selectAudio(String language);
// 오디오 트랙 정보 조회 API (MediaPlayer.onPrepared() 이벤트 수신 이후 호출 가능)
public MediaPlayerBase.TrackInfo[] getTrackInfo();TrackInfo내부 메서드public int getTrackType();
public String getLanguage();- 트랙 타입
MEDIA_TRACK_TYPE_UNKNOWNMEDIA_TRACK_TYPE_VIDEOMEDIA_TRACK_TYPE_AUDIOMEDIA_TRACK_TYPE_TIMEDTEXT
- 변경 사유: 다중 오디오 지원
- 영향 범위: 없음
- 앱 변경 여부: 없음
Deleted APIs
MediaPlay.erreleaseWhenFinishing메서드 제거- 변경 사유: 더 이상 사용되지 않음
- 영향 범위: 없음
- 앱 변경 여부: 없음
Fixed
-
재생 중 새로운 콘텐츠 재생 시 -8028 에러 발생 수정
- 변경 사유: v3.0.12 버전에서 버퍼링 중 종료 시 ANR 방지 패치에 따른 사이드 이펙트 보완
- 영향 범위: 없음
- 앱 변경 여부: 없음
-
DRM 콜백 데이터 유효성 방어 코드 추가
- 변경 사유:
expiration_date,expiration_count,expiration_playtime값이 정수형이 아닌 문자열로 유입될 때 플레이어가 강제 종료(Crash)되는 현상 방어 - 영향 범위: 없음
- 앱 변경 여부: 없음
- 변경 사유:
-
DRM 만료 콘텐츠 재생 시
onError로 잘못된 에러 코드가 전달되는 버그 수정- 변경 사유: 다운로드된 콘텐츠가
expiration_count또는expiration_playtime누적으로 인해 만료되었을 때, 플레이어onError이벤트 델리게이트로 올바르지 않은 에러 코드가 전달되던 버그 수정 (v3.0.4 버전 버그 보완) - 영향 범위: 없음
- 앱 변경 여부: 없음
- 변경 사유: 다운로드된 콘텐츠가
-
LMS 통계 데이터(
runtime,showtime) 계산 기준 변경- 변경 사유: 재생 중 디바이스의 시스템 시각이 변동하는 경우 LMS 통계 수치가 부정확해지므로 시간 측정 기준을 디바이스 시스템 시각에서 디바이스 부팅 이후 실제 경과 시간으로 변경
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.15
Release Date: 2026-04-14
Fixed
- 약전계에서 버퍼링 중 플레이어 종료 시 ANR(앱 응답 없음) 현상 개선
- 재현 경로 : 스트리밍 재생 중 비행기 모드 진입 > 탐색(Seek) 조작 > 플레이어 종료 시 ANR 발생
- 변경 사유: 버퍼링 중 플레이어 종료 시 ANR 현상 개선
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.14
Release Date: 2026-03-19
Added Features
-
라이브 동시 접속자 수 리포팅 전송
- 변경 사유: 라이브 동시 접속자 수 통계를 상세히 수집하기 위함
- 영향 범위: 없음
- 앱 변경 여부: 없음
-
라이브 비인가 IP 재생 차단
- 변경 사유: 라이브 재생 링크 노출에 대한 방어책
- 영향 범위: 없음
- 앱 변경 여부: 없음
-
Kibana에 에러 로그를 보고할 때 에러 스택 트레이스(error stack trace)가 포함된 로그 메시지를 전송하도록 수정
- 변경 사유: Exception으로 인한 에러 발생 시 자세한 정보 필요
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.13
Release Date: 2026-01-26
Added APIs
playback_limit기능 추가// KollusContent Class
public int getPlaybackLimitDuration();
public String getPlaybackLimitMessage();- 변경 사유: 특정 UTC Time까지 재생을 원하는 고객사 요구사항 반영
- 영향 범위: 없음
- 앱 변경 여부: 없음
Added Features
- 콘텐츠 다운로드 기능 이벤트 데이터 수집
- 변경 사유: 콘텐츠 다운로드 관련 통 계 수집
- 영향 범위: 없음
- 앱 변경 여부: 없음
Changed Features
-
StorageManager의 내부 함수 hidden 처리
- 변경 사유: SDK 보안 강화
- 영향 범위: 없음
- 앱 변경 여부: 없음
-
프록시 서버 종료를 Thread에서 처리
- 변경 사유: Google Play의 ANR에 대응
- 영향 범위: 없음
- 앱 변경 여부: 없음
Fixed
- ABR 콘텐츠 재생 시 간헐적 Crash 현상 수정
- 변경 사유: 내부적으로 bitrate 변경 시 NullPointerException에 대응
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.12
Release Date: 2025-12-16
Fixed
-
AI 챕터가 있는 콘텐츠 재생 시 강제 종료되는 현상 수정
- 변경 사유: 3.0.11에서 3.0.10으로 롤백 과정에서 AI 챕터 오류가 원복되어 강제 종료되는 현상 발생
- 영향 범위: 3.0.11을 사용하는 고객사 중 AI 챕터 서비스를 이용하는 고객사는 반드시 패치 필요
- 앱 변경 여부: 없음
-
중복 재생 차단이 설정되지 않은 콘텐츠 다운로드 시 강제 종료되는 현상 수정
- 변경 사유: 다운로드 시 중복 재생 차단이 설정되지 않았는데 체크하다 강제 종료되는 현상 발생
- 영향 범위: 중복 재생 차단 설정이 되어 있지 않은 상태에서 다운로드를 사용하는 고객사
- 앱 변경 여부: 없음
3.0.11
Release Date: 2025-12-05
Changed Features
- DRM Callback, PlayCallback 에러 코드가 -9000, -10000대 나오도록 수정 사항 원복
- 변경 사유: 에러 코드 변경으로 인해 오류 메시지 매핑이 되지 않아 메시지가 변경되는 현상이 발생하여 원복
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.10
Release Date: 2025-12-04
Added APIs
-
사용자 행동 분석 관련 API 추가
// KollusContent Class
public String getActionStatsUrl();
public String getActionStatsSecretKey();- 변경 사유: 사용자 행동 분석을 통해 UI 기획 등에 활용
- 영향 범위: 없음(KollusPlayer App에서 사용)
- 앱 변경 여부: 없음
-
챕터 기능 추가
// KollusContent Class
public String getDefaultChapterLanguage();
public List<ChapterInfo> getChapterInfos();
// KollusContent.ChapterInfo Class
public String getLanguage();
public List<Chapter> getChapters();- 변경 사유: 구간별 소제목을 표시하여 사용자에게 해당 구간의 대략적인 내용 전달
- 영향 범위: 없음
- 앱 변경 여부: 없음
Added Features
- 엣지 서버 접속 시 keep alive 추가
- 변경 사유: 서버 네트워크 자원 효율성 강화
- 영향 범위: 없음
- 앱 변경 여부: 없음
Changed Features
-
DRM Callback, PlayCallback 에러 코드가 -9000, -10000대 나오도록 수정
- 변경 사유: 일부 에러 코드가 -8000대로 출력되어 에러 코드만으로 오류 분석 어려움
- 영향 범위: 없음
- 앱 변경 여부: 없음
-
KollusPlayerLMSListener.onLMS의 response data 변경
// Before
{"error":1,"status":"HTTP Code:28"}
// After
{"error":1, "code":28, "time":10005}- 변경 사유: LMS 데이터의 전송 결과에 소비한 시간 추가. 단순히 디버깅 용도이기에 앱 영향은 없습니다.
- 영향 범위: 없음
- 앱 변경 여부: 없음
Fixed
-
QoE 데이터의 dns lookup, connect, tls handshake의 값이 추가되어 잘못 올라가는 현상 수정
- 변경 사유: QoE 데이터 오류 수정
- 영향 범위: 없음
- 앱 변경 여부: 없음
-
LMS 데이터의 showtime이 간헐적으로 잘못 올라가는 경우 수정
- 변경 사유: LMS 데이터의 showtime이 간헐적으로 음수나 갑자기 튀는 현상이 보고되어 해당 데이터에 오류가 감지되면 이전 값으로 올라가도록 수정
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.9
Release Date: 2025-09-04
Fixed
- KollusStorage의 finish 호출 시 강제 종료되는 현상 수정
- 변경 사유: finish 시 QoE 인스턴스를 초기화하지 않아서 강제 종료되는 현상으로 버그 패치
- 영향 범위: SDK 3.0.8 적용 고객사 중 KollusStorage의 finish를 사용하는 고객사는 수정된 SDK 적용 필요
- 앱 변경 여부: 없음
3.0.8
Release Date: 2025-08-06
Added APIs
- QoE 기능 추가
- 변경 사유: 네트워크 품질 평가를 위한 기능 추가
- 영향 범위: 없음
- 앱 변경 여부: 없음
KollusContent에 아래 API 추가
/**
* 채널 키를 가져오는 함수
* @return 채널 키
*/
public String getChannelKey();
/**
* [Internal SDK Only]
* QoE 세션 정보를 보내는 URL
* @return 세션 URL
*/
public String getQoeSessionUrl();
/**
* [Internal SDK Only]
* QoE 네트워크 정보를 보내는 URL
* @return 네트워크 URL
*/
public String getQoeNetworkUrl();
/**
* [Internal SDK Only]
* QoE 재생 정보를 보내는 URL
* @return 재생 정보 URL
*/
public String getPlaybackUrl();
/**
* [Internal SDK Only]
* QoE 암호화 키
* @return 암호화 키
*/
public String getQoeSecretKey();
Changed Features
- 라이브 중 방송 종료 시 playback complete이 아닌 -3012(방송 중이 아님)으로 변경
- 변경 사유: 라이브 방송 종료 시 playback complete 처리로 앱이 종료되던 것을, 사용자가 인지할 수 있도록 -3012 에러 팝업을 표시하도록 수정
- 영향 범위: 없음
- 앱 변경 여부: 없음
Added Features
- 16KB page size 지원
- 변경 사유: Android 15부터 16KB page size 지원을 시작해서 선제 대응(기존은 4kb page size였음). 16kb 단말에서 4kb 라이브러리를 사용하면 런타임에 앱 crash 발생
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.7
Release Date: 2025-06-12
Fixed
-
리스너 미등록 시 안정화 코드 추가
- 변경 사유: MediaPlayer.setKollusPlayerLMSListener 미등록 시 crash 현상 발견
- 영향 범위: 없음
- 앱 변경 여부: 없음
-
버퍼링 중에 종료 시 안정성 강화
- 변경 사유: 안정성 강화
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.6
Release Date: 2025-05-16
Added APIs
- AI자막
KollusContents.SubtitleInfo에 아래 항목 추가public boolean ai; - 변경 사유: AI 생성자막 여부(true: AI 생성자막, false: 일반자막)
- 영향 범위: 없음
- 앱 변경 여부: 없음
Changed Features
- MediaPlayer에서 setMute 제거
- 변경 사유: KollusMediaPlayer에서 소프트웨어적으로 묵음처리하는 API로 더 이상 필요 없음(3.0.4 이후)
- 영향 범위: 없음
- 앱 변경 여부: 없음
Fixed
- PlayCallback의 비정상 response에 대한 예외처리
- 변경 사유: 일부 고객의 비정상 response에 대한 예외처리 (일본 고객과는 무관)
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.5
Release Date: 2025-04-08
Added APIs
- 백그라운드 오디오 재생 기능 제어 옵션 항목 추가
- 변경 사유: 백그라운드 재생 시 미디어 알림에 필요 사항 추가
- 영향 범위: 없음
- 앱 변경 여부: 없음
- KollusContent에 아래 API 추가
/**
* [Internal SDK Only]
* 콘텐츠 제공자의 이름을 가져오는 함수
* @return 콘텐츠 제공자 이름
*/
public String getContentProviderName();
/**
* 백그라운드 재생 관련 사용자 설정을 무시할 지 여부를 가져오 는 함수
* @return true이면 사용자 설정과 관계없이 무조건 백그라운드 재생을 허용하지 않는다
* false이면 사용자 설정에 따라서 백그라운드 재생 여부를 판단한다
*/
public boolean isDisableBackgroundAudio();
Changed Features
- Database에 있는 LMS 데이터 비동기 방식으로 보내도록 수정
- 변경 사유: 전송 실패한 LMS 데이터가 있는 경우 동기(Sync) 방식으로 재전송하고 있어, 네트워크 지연 시 아래 상황에서 ANR이 발생할 수 있어 비동기(Async) 방식으로 변경
- Pause상태에서 Seek시
- 재생 초기에 종료 시
- 영향 범위: 없음
- 앱 변경 여부: 없음
- 변경 사유: 전송 실패한 LMS 데이터가 있는 경우 동기(Sync) 방식으로 재전송하고 있어, 네트워크 지연 시 아래 상황에서 ANR이 발생할 수 있어 비동기(Async) 방식으로 변경