Security · DRM
보안·DRM 용어
누가, 어떤 앱과 기기에서 재생할 수 있는지 정하는 말입니다.
| 용어 | 뜻 | 도입 검토 때 의미 |
|---|---|---|
| DRM 패키징 | 영상 파일을 DRM 콘텐츠로 바꾸는 작업입니다. 콘솔에서 받는 명령줄 도구 ndrm-pkg로 하며 macOS·Windows·Linux용이 있습니다. | 패키징할 영상 범위를 정합니다. 일반 파일 서비스도 됩니다. |
| 라이선스 키 | 인증 서버가 재생을 위해 발급하는 키입니다. 인증 서버는 세션도 관리합니다. | 발급 시점에 고객사 서버가 재생 여부를 판단합니다. |
| 앱 등록 | 콘솔에 앱의 패키지 이름(Bundle ID)을 등록합니다. 미등록 앱에서는 플레이어가 오류를 냅니다. | 새 앱을 낼 때 콘솔 등록부터 합니다. |
| 동시 접속 | 동시 접속이 감지되면 SDK와 커스텀 페이지에 MultipleConnections 오류가 전달됩니다. | 계정 공유 대응 기준을 정합니다. |
| 디바이스 수 제한 | 기기 제한을 넘으면 재생과 다운로드가 실패합니다. 고객사 서버가 DeviceLimitExceeded로 답할 수도 있습니다. | 허용 기기 수와 콘솔 디바이스 관리 담당을 정합니다. |
| 녹화·캡처 차단 | 화면 녹화·캡처를 막는 기능으로 PlaynPlay App과 Android·iOS SDK에 있습니다. iOS SDK는 캡처 감지를 오류로 알립니다. | 오픈 전 기기별로 녹화 앱을 켜고 확인합니다. |
| 워터마크 (Android) | 영상 위 글자 표시입니다. 문구, 색, 불투명도, 크기, 유지 시간, 주기를 정하고 위치는 고정 5곳·무작위 7가지입니다. | 유출 시 출처를 알 수 있는 문구를 정합니다. |
| 루팅·앱 플레이어 탐지 (Android) | 기기 루팅이나 앱 플레이어가 감지되면 Android SDK가 앱에 알립니다. | 감지 뒤 재생을 멈출지 앱 기획에 넣습니다. |
| 디버깅 프록시 방어 | 2026.01.30 Android·iOS SDK에 추가된 보안 항목입니다. | 이 날짜 이후 SDK로 올려야 적용됩니다. |
보안 기능 전체는 보안 기능 소개에 있습니다.
Integration
연동 용어
고객사 웹, 앱, 서버가 PlaynPlay와 주고받는 값입니다.
| 용어 | 뜻 | 도입 검토 때 의미 |
|---|---|---|
| App ID·App Key | 콘솔에서 App을 만들면 받는 값으로, 라이선스 키 발급 요청에 쓰입니다. SDK와 Agent 설정에 App ID를 넣습니다. | 서비스마다 App을 나눌지 정합니다. |
| 사용자 아이디 | DRM 설정의 필수 사용자 식별값(userId)입니다. 모든 Callback URL 요청에 실려 옵니다. | LMS 회원 ID와 같은 값을 쓰면 대조가 쉽습니다. |
| userData | 고객사가 사용자·콘텐츠 식별용으로 Callback URL에 보내는 데이터입니다. | 강좌·차시 ID를 넣어 진도 처리에 씁니다. |
| Callback URL | 콘솔에 등록하는 고객사 서버 주소입니다. 플레이어가 8종 요청을 보내고 응답에 따라 동작합니다. | 서버 개발 범위를 8종 요청으로 잡습니다. |
| 접근 권한 검사 | CheckAccessRights. 라이선스 발급 때 호출되며 Ok, Expired, NoRights, DeviceLimitExceeded로 답합니다. Ok면 접근 만료 일시도 보냅니다. | 수강 기간·결제 상태 판정이 여기 들어갑니다. |
| Agent | 웹 페이지에 넣는 agent.js입니다. playnplay.launch()로 PlaynPlay App을 열어 재생, 다운로드, 커스텀 페이지 열기를 합니다. 이 사이트의 Web-to-App 방식입니다. | 웹 LMS는 재생 버튼 호출만 바꿉니다. |
| 앱 최소 버전 | Agent 설정의 minVersion입니다. 이 버전 이상인 PlaynPlay App에는 업데이트 알림을 하지 않습니다. | 중요 업데이트 뒤 값을 올릴지 정합니다. |
| MediaItem | 재생 한 건의 설정 묶음입니다. URL, DRM, 자막, 클리핑, 탐색·배속 허용, 시작 시간 등을 담습니다. | 콘텐츠별 정책은 이 단위로 정합니다. |
Playback
재생·플레이어 용어
학습자가 쓰는 기능과 콘텐츠마다 거는 재생 조건입니다.
| 용어 | 뜻 | 도입 검토 때 의미 |
|---|---|---|
| 탐색 제한 | 콘텐츠마다 재생 위치 이동(Seek)을 막습니다. 기본값은 허용입니다. | 의무 교육 과정에 켭니다. |
| 배속 제한 | SDK 재생 속도는 0.1~4.0배입니다. 콘텐츠마다 배속을 끄는 설정은 2025.03.20에 추가됐습니다. | 인정 시간이 걸린 과정의 정책을 정합니다. |
| 구간 반복 | 시작·끝 지점을 정해 그 구간을 반복 재생합니다. | 어학·실기 반복 연습에 맞습니다. |
| 클리핑 | 미디어를 지정한 시작·끝 위치로 잘라 재생합니다. Agent와 iOS SDK 문서에 있습니다. | 원본 하나로 미리보기 구간을 만듭니다. |
| PiP (화면 속 화면) | 작은 창으로 보며 다른 앱을 씁니다. 기본값은 허용이고 Android는 8.0 이상입니다. | 과정 성격에 맞춰 허용 여부를 정합니다. |
| 백그라운드 재생 | 앱 화면을 벗어나도 재생을 이어 갑니다. 기본값은 꺼짐입니다. | 오디오 중심 강의에만 켤 수 있습니다. |
| 북마크 | 제목과 재생 위치를 저장합니다. 기본은 PlaynPlay 서비스에 저장하고, 북마크 콜백을 켜면 고객사 서버가 주고받습니다. | 기존 북마크 데이터를 계속 쓸지 정합니다. |
| 시작 시간 (이어보기) | 재생 시작 위치(초)입니다. 갱신 시각을 함께 주면 오프라인에 저장된 최근 재생 위치와 비교해 더 최근 값으로 시작합니다. | 서버 위치와 오프라인 시청 위치를 맞춥니다. |
| 자막 | Android SDK는 WebVTT, SRT, SAMI 자막의 다중 선택을 지원합니다. 위치, 크기, 색, 배경, 여백을 조정하고 다운로드 때 함께 저장합니다. | 보유 자막 형식부터 확인합니다. |
| 셀룰러 데이터 허용 | 재생과 다운로드 각각에 모바일 데이터 사용 여부를 정합니다. | Wi-Fi 전용으로 둘지 정합니다. |
화면별 설명은 플레이어 기능에 있습니다.
Operations · Data
운영·데이터 용어
콘솔 운영과 고객사 서버가 받는 기록에 관한 말입니다.
| 용어 | 뜻 | 도입 검토 때 의미 |
|---|---|---|
| PlaynPlay Console | 사용자·세션 통계, 녹화 차단, 디바이스, 재생 통계, 보안·워터마크를 관리하는 사이트입니다. App 생성과 Callback URL 설정도 합니다. | 콘솔 운영 담당자를 정합니다. |
| 보고 주기 | 재생 진행 상태를 보내는 간격(Interval)으로 콘솔에서 정합니다. 2026.08.25 SDK부터는 진행 상태가 그대로면 보고를 건너뜁니다. | 보고가 잠시 끊기는 경우를 서버 로직에 반영합니다. |
| 재생 진행 상태 보고 | NotifyPlaybackProgress. 보고 주기마다 현재 위치, 전체 길이, 재생 시간, 시청 시간을 보냅니다. | 진도율 계산의 기본 데이터입니다. |
| 실제 시청 시간 | 시청 시간(watchTime)은 실제 시간, 재생 시간(playTime)은 영상 기준입니다. 2배속으로 1초 보면 각각 1초, 2초입니다. | 인정 시간을 어느 값으로 셀지 정합니다. |
| 재생 제한 초과 | 진행 상태 보고에 고객사 서버가 PlaybackLimitExceeded로 답하는 경우입니다. 문서는 배수 제한, 재생 횟수를 예로 듭니다. | 허용 기준은 고객사가 정합니다. |
| 재생 종료 이유 | Ended(끝까지 재생), Error(오류), UserExited(사용자 종료) 중 하나로 재생 종료 보고에 실립니다. | 완강 판정에 Ended만 인정할지 정합니다. |
| 다운로드 매니저 | 앱 안에서 다운로드를 추가, 일시정지, 재개, 삭제합니다. Android 동시 다운로드 기본값은 3개입니다. | 다운로드 목록 화면을 기획합니다. |
| 오프라인 재생 기한 | 다운로드 콘텐츠를 오프라인으로 볼 기간(초)입니다. 비우면 제한 없음, 0이면 오프라인 재생 불가입니다. | 수강 기간에 맞춰 정합니다. |
| 오프라인 재생 정보 보고 | NotifyOfflinePlaybackLog. 오프라인이라 못 보낸 재생 기록을 온라인 연결 때 보냅니다. | 다운로드 학습도 진도에 넣습니다. |
진도율 계산은 진도 데이터 설계 가이드, 콘솔 화면은 콘솔 기능에 있습니다.
Platforms
플랫폼 용어
PlaynPlay가 동작하는 기기와 개발 환경입니다.
| 용어 | 뜻 | 도입 검토 때 의미 |
|---|---|---|
| PlaynPlay App | Windows 10 이상, macOS 11 이상에 설치하는 데스크톱 플레이어로, 별도 설치 파일로 제공됩니다. | 사용자 PC 설치 안내를 준비합니다. |
| 커스텀 페이지 (Desktop) | PlaynPlay App 안에서 여는 고객사 웹 페이지입니다. video 요소로 재생하고 북마크 조회, 세션 오류 수신, 앱 종료를 처리합니다. | 학습 화면을 자사 디자인으로 만듭니다. |
| WebView2 | Microsoft의 웹 화면 구성 요소입니다. PlaynPlay App 1.0.32(2025.12.09)에서 WebView2 143.0.3650.66이 로컬 네트워크 접근 제한을 기본으로 켜면서 생긴 재생 문제를 고쳤습니다. | PC 환경 변화에 맞춘 앱 업데이트를 안내합니다. |
| Android SDK | Android 7.1(API 수준 25) 이상 앱용 플레이어입니다. 다운로드, 워터마크, 루팅·앱 플레이어 탐지를 지원합니다. | 앱의 최소 지원 Android 버전과 맞춰 봅니다. |
| Media3 | Android SDK가 기반으로 삼은 안드로이드의 Jetpack Media3 라이브러리입니다. Media3 기능을 그대로 쓰고, 직접 구성한 플레이어를 등록할 수도 있습니다. | 앱 개발팀의 Media3 사용 경험을 확인합니다. |
| iOS SDK | iOS 13.0 이상 앱용 플레이어입니다. 재생 목록, 다운로드, 화면 속 화면을 지원합니다. | 앱의 지원 iOS 버전과 맞춰 봅니다. |
플랫폼별 안내는 PC, Android, iOS 페이지에 있습니다. 플레이어 배경은 nPlayer 소개, 날짜별 변경은 업데이트 기록을 보세요.
Related
함께 보면 좋은 페이지
-
자료
Resources
도입 검토부터 운영까지 필요한 자료를 한곳에
Resources 자세히 보기 -
가이드
도입 실행 가이드
상담부터 운영까지 단계별 할 일과 담당자를 한 장에 정리했습니다
도입 실행 가이드 자세히 보기 -
플랫폼
플랫폼 비교
PC App·Android SDK·iOS SDK를 한 표에서 나란히 봅니다
플랫폼 비교 자세히 보기
Get Started
PlaynPlay 도입을 위한
PlaynPlay 도입을 위한
기술적 지원과 서비스를 제공합니다.
제품 문의부터 데모 시연까지, 모든 지원을 위해 세일즈 및 기술 지원 팀이 준비되어 있습니다.
-
제품 및 도입 문의
도입 범위, 일정, 견적을 상담합니다. 서비스 형태와 사용자 규모를 알려주시면 맞는 연동 방식과 보안 설정을 제안합니다.
-
Trial 신청
PlaynPlay의 기능을 먼저 테스트해 보세요. 트라이얼 기간 동안 귀사의 제품과 PlaynPlay를 연동하고 성능과 기능을 직접 검증할 수 있습니다.
-
PlaynPlay 기술 문의
SDK 연동, Callback URL 설계, DRM 패키징 중에 생기는 질문에 기술팀이 답합니다. 공개된 개발 문서와 샘플 프로젝트도 함께 확인하세요.