릴리즈 노트
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에서 처리
- 변경 이유: 플레이 스토어의 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 hand shake의 값이 추가되어 잘못 올라가는 현상 수정
- 변경 이유: QoE 데이터 오류 수정
- 영향 범위: 없음
- 앱 변경 여부: 없음
-
LMS 데이터의 showtime이 간헐적으로 잘못 올라가는 경우 수정
- 변경 이유: LMS 데이터의 showtime이 간헐적으로 음수나 갑자기 튀는 현상이 보고되어 해당 데이터에 오류가 감지되면 이전 값으로 올라가도록 수정
- 영향 범위: 없음
- 앱 변경 여부: 없음
3.0.9
Release Date: 2025-09-04
Changed Features
- 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 라이브러리를 사용하면 run time에 앱 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 getContentProvierName();
/**
* 백그라운드 재생 관련 사용자 설정을 무시할 지 여부를 가져오는 함수
* @return true이면 사용자 설정과 관계없이 무조 건 백그라운드 재생을 허용하지 않는다
* false이면 사용자 설정에 따라서 백그라운드 재생 여부를 판단한다
*/
public boolean isDisableBackgroundAudio();
Changed Features
- DataBase에 있는 LMS 데이터 Async하게 보내도록 수정
- 변경 이유: 못 보낸 LMS 데이터가 있는 경우 Sync하게 데이터를 보내고 있는데 네트워크 이슈로 오래 걸릴 수 있어서 아래의 상황에서 ANR 발생 제거
- Pause상태에서 Seek시
- 재생 초기에 종료 시
- 영향 범위: 없음
- 앱 변경 여부: 없음
- 변경 이유: 못 보낸 LMS 데이터가 있는 경우 Sync하게 데이터를 보내고 있는데 네트워크 이슈로 오래 걸릴 수 있어서 아래의 상황에서 ANR 발생 제거
3.0.4
Release Date: 2025-03-13
Added Features
- 에러 수집 고도화
- KollusContent에 아래 API 추가
/**
* [Internal SDK Only]
* 에러 발생 시 에러 수집할 서버 UAL 주소
* @return UAL 에러 서버 주소
*/
public String getUalErrorReportUrl();
/**
* [Internal SDK Only]
* 에러 발생 시 에러 수집할 서버 주소
* @return 에러 서버 주소
*/
public String getErrorReportUrl();
/*
* [Internal SDK Only]
* 콘텐츠 제공자를 가져오는 함수
* @return 콘텐츠 제공자
*/
public String getContentProvierKey() ;
/*
* [Internal SDK Only]
* 에러 발생 시 수집할 서버에 보낼 추가적인 데이터
* @return 추가 데이터
*/
public String getErrorAdditionalInfo();
- KollusContent에 아래 API 추가
Changed Features
- 오디오 워터마크 지원 종료
- 변경 이유: 지원 종료
- 영향 범위: 없음
- 앱 변경 여부: 제거되는 API를 사용하는 고객
- KollusMediaPlayer 제거
- 변경 이유: 해당 플레이어는 5.0미만이거나 오디오 워터마크 콘텐츠 재생 시 사용하는 것으로 더이상 필요 없어짐
- 아래 항목 제거
- MediaPlayer에서 제거
- setVolumeLevel
- enum RENDER_MODE
- OnCencDrmListener
- setOnCencDrmListener
- getPlayerType
- KollusContent에서 제거
- getAudioWaterMark
- Utils에서 제거
- getPlayerType
- setRenderType
- getRenderType
- enum DecoderType
- setDecoderType
- getDecoderType
- MediaPlayer에서 제거
- 에러 수집 고도화
- 변경 이유: 미디어 정보를 가져오기 전에 에러 발생 시 에러 코드를 수집하기 위함
- build.gradle 수정
implementation 'com.squareup.okhttp3:okhttp:4.12.0'
implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0' - KollusStorage 초기화 오류 코드 변경
- ErrorCodes에서 아래 값 제거
/**
* 인증키 만료
*/
public static final int ERROR_EXPIRED_KEY = -2;
/**
* 인증키 오류
*/
public static final int ERROR_INVALID_KEY = -1; - ErrorCodes에서 아래 값 추가
/**
* KollusStrage 초기화 시 잘못된 PackageName을 제공함
*/
public static int ERROR_INCORRECT_PACKAGE_NAME = -2103;
/**
* KollusStrage 초기화 시 사용기한 만료
*/
public static int ERROR_EXPIRED_AUTH_DATE = -2104;
/**
* KollusStrage 초기화 시 사용기한 입력포맷이 잘못됨
*/
public static int ERROR_INCORRECT_AUTH_DATE = -2105;
/**
* KollusStrage 초기화 시 인증키가 잘못됨
*/
public static int ERROR_INCORRECT_AUTH_KEY = -2106;
/**
* KollusStrage 초기화 시 인증정보가 모두 입력되지 않았음
*/
public static int ERROR_NOT_ENOUGH_AUTH_INFO = -2107; - 변경 이유: iOS와 오류 코드 맞춤
- 앱 변경 여부: KollusStorage.initialize의 에러 코드값을 체크 시 수정된 에러코드로 체크해야 함
- ErrorCodes에서 아래 값 제거
3.0.3
Release Date: 2025-01-14
Added APIs
- 다음 회차 버튼 show/hide 옵션 추가
- KollusContent에 아래 API 추가
/**
* 다음 회차 자동 재생이어도 getNextEpisodeShowTime의 시간 내에 있는 경우 UI 버튼을 보여줄 지 여부를 가져오는 함수
* @return 다음 회 버튼 보여줄지 여부(true:보여줌, false:숨김)
*/
public boolean isNextEpisodeShowButton(); - 변경 이유: 자동으로 다음 회차 재생 옵션을 켠 경우 다음회 버튼 미노출되는데 고객 요구로 다음회 버튼 노출을 위함. SDK 사용하는 고객사는 직접 구현해도 무방합니다.
- 영향 범위: No(해당 flag 값을 필요로 하는 고객사에만 적용 필요)
- 앱 변경 여부: No(해당 flag 값을 필요로 하는 고객사에만 적용 필요)
- KollusContent에 아래 API 추가
Added Features
- 콘텐츠별 미디어인포 복호화 키 적용
- 변경 이유: 보안강화
- 영향 범위: No
- 앱 변경 여부: No
- Multi DRM 콘텐츠 다음 회차 재생 기능 지원
- 변경 이유: 기능추가
- 영향 범위: Multi DRM 콘텐츠 사용고객
- 앱 변경 여부: No
Fixed
- onDetectDebuggingMode을 사용하여 앱 종료 시 1분 후에 앱 크래시 되는 현상 수정
- 변경 이유: 버그 수정
- 영향 범위: 해당 API를 사용하여 앱을 종료하는 고객
- 앱 변경 여부: Yes
3.0.2
Release Date: 2024-11-07
Added APIs
- KollusContent에 public boolean isIgnoreZero() 추가
- 재생 URL의 Query parameter로 전달된 ign_z flag의 값을 반환합니다. (default: false)
- 변경 이유: 이어보기 정보가 앞뒤로 일정시간 미만이면(Kollus 플레이어는 10초 미만) 처음부터 재생하는 시나리오를 무시하고 이어보기를 원하는 고객사의 요구로 추가
- 영향 범위: No(해당 flag 값을 필요로 하는 고객사에만 적용 필요)
- 앱 변경 여부: No(해당 flag 값을 필요로 하는 고객사에만 적용 필요)
Added Features
- KollusContent에 public boolean isIgnoreZero() 추가
- 재생 URL의 Query parameter로 전달된 ign_z flag의 값을 반환합니다. (default: false)
- 변경 이유: 이어보기 정보가 앞뒤로 일정시간 미만이면(Kollus 플레이어는 10초 미만) 처음부터 재생하는 시나리오를 무시하고 이어보기를 원하는 고객사의 요구로 추가
- 영향 범위: No(해당 flag 값을 필요로 하는 고객사에만 적용 필요)
- 앱 변경 여부: No(해당 flag 값을 필요로 하는 고객사에만 적용 필요)
Changed Features
- Kollus DRM 및 콘텐츠 보안 강화
- 변경 이유: Kollus 보안 강화
- 영향 범위: Kollus 사용 고객 (V/G 암호화 버전 업그레이드 및 DRM 암/복호화 모듈 업데이트)
- 앱 변경 여부: No
Fixed
- AI배속 안되는 현상 수정
- 변경 이유: media3부터 발생하는 버그 수정
- 영향 범위: AI배속 기능 사용 고객
- 앱 변경 여부: No
- 아래와 같은 구글의 앱 취약성 경고 대응
- 앱에 암시적인 내부 인텐트 취약성이 있습니다.
com.teruten.mcm.module.a0.F - 변경 이유: 구글 앱 취약성 경고로 인한 모듈 업데이트
- 영향 범위: Google Play Console에서 해당 경고 발생시 업데이트 필요
- 앱 변경 여부: No
- 앱에 암시적인 내부 인텐트 취약성이 있습니다.
3.0.1
Release Date: 2024-09-11
Added APIs
- MediaPlayer에 API 추가
/**
* LMS데이터를 보낼 때 앱상태가 background 또는 foreground될 때의 시간도 같이 보내기 위해 앱 상태가 변경되는 시점을 저장하는 함수
* LMS Callback 설정에 {APP_STATUS_JSON}를 추가한 경우 유효합니다.
* @param status 앱 상태
*/
public void setAppStatus(@APP_STATUS int status); // 1: background, 2: foreground- 변경 이유: 백그라운드에 사용자가 머물러 있는 시간을 계산하기 위한 기능 추가
- 영항 범위: 신규 API이므로 영향 없음
- 앱 변경 여부: 필요 없음
Fixed
- Seek 중에 종료 시 NullPointerException 대응(Google Play Console의 vitals 대응)
- 변경 이유: SDK 3.0.0에서 확인된 버그 fix
- 영향 범위: SDK 3.0.0을 적용한 앱의 경우 영향 발생, 3.0.1 적용 필수
- 앱 변경 여부: 필요 없음
3.0.0
Release Date: 2024-08-29
Changed APIs
- KollusStorage의 setDevice/setDeviceASync 변경
- 변경 사유: 자체 플레이어 ID 사용을 원하는 요구 사항으로 인해 변경
- 변경 전
public int setDevice(String storagePath, String playerId, String playerIdMd5, boolean bTablet);
public void setDeviceASync(String storagePath, String playerId, String playerIdMd5, boolean bTablet, OnKollusStorageDeviceListener listener); - 변경 후
public int setDevice(String storagePath, boolean bTablet);
public void setDeviceASync(String storagePath, boolean bTablet, OnKollusStorageDeviceListener listener);
Added Features
- ExoPlayer2에서 media3로 업그레이드
- 변경 사유: ExoPlayer2를 더이상 구글에서 지원을 안함
- Multi DRM 라이브러리 변경
- 변경 사유: media3로 변경되어 수정
Fixed
- SRT 자막 개행 문자 누락에 대한 예외처리
- 종료 시 nscreen 데이터에만 ai관련 정보 송출
Warning
- 자체 PlayerId를 사용하는 경우(Utils.setPlayerId 호출하는 경우) KollusStorage의 setDevice/setDeviceASync호출 전에 Utils.setPlayerId로 PlayerId를 설정해야 합니다.
- 프로가드 수정
- exoplayer2 항목 제거
- 아래 항목 추가
-dontwarn androidx.media3.**
-keep interface androidx.media3.** { *; }
- Multi DRM 라이브러리 변경
- 이전 버전에서 다운로드 받은 Multi DRM 콘텐츠는 호환되지 않습니다. 즉, 다운로드 목록에는 표시는 되지만 재생은 할 수 없습니다.
- minSDK가 21로 올라갑니다.
- PallyconWVMSDK.aar를 서브프로젝트로 추가를 하든 libs폴더에 추가를 해야 합니다.
- build.gradle 수정
- Multi DRM 라이브러리가 코틀린으로 되어 있어서 코틀린 설정을 해야 합니다.
//apply plugin: 'com.android.application'
plugins {
id 'com.android.application'
id 'org.jetbrains.kotlin.android'
id 'kotlin-android'
id 'kotlin-parcelize'
}
- Multi DRM 라이브러리가 코틀린으로 되어 있어서 코틀린 설정을 해야 합니다.
- media3 관련 dependencies 추가
- build.gradle 수정
dependencies {
api ('com.google.guava:guava:31.1-android') {
// Exclude dependencies that are only used by Guava at compile time
// (but declared as runtime deps) [internal b/168188131].
exclude group: 'com.google.code.findbugs', module: 'jsr305'
exclude group: 'org.checkerframework', module: 'checker-compat-qual'
exclude group: 'org.checkerframework', module: 'checker-qual'
exclude group: 'com.google.errorprone', module: 'error_prone_annotations'
exclude group: 'com.google.j2objc', module: 'j2objc-annotations'
exclude group: 'org.codehaus.mojo', module: 'animal-sniffer-annotations'
}
compileOnly 'com.google.errorprone:error_prone_annotations:2.15.0'
compileOnly 'org.checkerframework:checker-qual:3.13.0'
compileOnly 'org.checkerframework:checker-compat-qual:2.5.0'
implementation "androidx.security:security-crypto-ktx:1.1.0-alpha03"
...
}
- build.gradle 수정
2.0.23
- AI배속 스크립트 패스 오류에 대한 방어 코드 추가
2.0.22
- 네트워크가 좋지 않을때 재생 시도 중 ExoPlayer에서 오류 발생 시 ANR 발생되는 현상 수정
- -1007: 에러 발생하는 상황의 에러코드 분리
-1018: KollusStorage 인자 오류 또는 재생 패스 오류 시
-1019: KollusStorage 초기화 안된 경우 - SocketTimeoutException발생 시 -1010에서 -8028로 변경
2.0.21
- 구글 미인증 단말에 Pallycon 라이브러리 초기화 강제 종료되는 문제 수정
단말명으로 초기화 skip
2.0.20
- AI배속 콘텐츠 정보 N-screen에 추가
- Kollus UserAgent에 ChromeOS 추가
2.0.19
- 다음 회차 추가
KollusContent에 아래 API 추가/**
* 다음 회차 Callback URL 가져오는 함수
* @return 다음 회차 Callback URL
*/
public String getNextEpisodeCallbackUrl();
/**
* 다음 회차 Callback URL 호출 시 post 데이터 가져오는 함수
* @return 다음 회차 Callback URL 호출 시 post 데이터
*/
public String getNextEpisodeCallbackData();
/**
* 다음 회차가 있는 경우 UI 버튼을 보여줄 시간 가져오는 함수
* @return 보여줄 시간
*/
public int getNextEpisodeShowTime(); - KollusContent API 정리
추가아래 함수 제외한 set함수 제거/**
* [Internal SDK Only]
* Parcel로 재생 콘텐츠 정보를 설정하는 함수
* @param in 콘텐츠 정보를 포함하는 Parcel
*/
public void setForPlay(Parcel in);
/**
* [Internal SDK Only]
* Parcel로 다운로드 콘텐츠 정보를 설정하는 함수
* @param in 콘텐츠 정보를 포함하는 Parcel
*/
public void setForDownload(Parcel in);
/**
* [Internal SDK Only]
* JSON String으로 콘텐츠 정보를 설정하는 함수
* @param jsonString 콘텐츠 정보를 포함하는 JSON String
*/
public void setByJSON(String jsonString);
/**
* 주어진 인자에 콘텐츠 정보를 복사하는 함수
* @param content 콘텐츠 정보를 복사할 대상 KollusContent
*/
public void copy(KollusContent content);public void setMediaContentKey(String key);
public void setContentType(ContentType type);
public void setUriIndex(int index);
public void setPlaytime(int playtime);
public void setReceivedSize(long receiveSize);
public void setReceivingSize(long receiveSize);
public void setFileSize(long fileSize);
public void setLocalMediaUrl(String mediaUrl);
public void setDownloadPercent(int percent);
public void setDownloadCompleted(boolean complete);
public void setDownloadError(boolean bError);
public void setLoaded(boolean bLoaded);
public void setContentExpired (boolean expired);
public void setDownloading(boolean downloading);
public void setDownloadCanceled();
public void setServiceProviderMessage(String message); - 라이브의 비디오 워터마크 오류 수정
- 2이하 단말에서 배속 재생 시 강제 종료되는 현상 수정