PlaynPlay
PlaynPlay

레거시 플레이어 전환 가이드

ActiveX·NPAPI·프록시 플레이어를
PlaynPlay로 옮기는 순서

레거시 보안 플레이어를 바꿀 때는 재생 화면만 옮겨서는 끝나지 않습니다. 학습자 PC 환경, 진도·북마크 데이터, 고객센터 안내를 함께 옮겨야 합니다. 이 가이드는 전환 순서와 미리 확인할 위험을 정리했습니다.

최종 수정

레거시 플레이어 전환을 표현한 PlaynPlay 일러스트
Why Now

레거시 방식은 브라우저 쪽에서 먼저 멈췄습니다

기존 플레이어 파일이 그대로 있어도, 그 플레이어를 실행하던 브라우저 기술은 지원이 끝났습니다. 남은 부담은 학습자와 고객센터가 집니다.

  • ActiveX

    IE 11에 묶인 재생 환경

    IE 11 데스크톱 앱에 대한 Microsoft 지원은 2022년 6월 15일 종료됐습니다. ActiveX 플레이어를 계속 쓰면 지원이 끝난 브라우저를 쓰라는 안내와 설정 문의가 고객센터에 계속 남습니다.

  • NPAPI

    최신 브라우저에서 열리지 않는 플러그인

    Chrome은 2015년, Firefox는 2017년에 NPAPI 지원을 끝냈습니다. 학습자 입장에서는 강의실에 들어가도 영상이 뜨지 않는 오류로 보입니다.

  • Proxy

    보안 프로그램 밖에 남는 구간

    로컬 프록시 방식은 PC에 설치한 프로그램이 영상을 풀어 브라우저 플레이어로 넘깁니다. 넘기는 통신 구간과 브라우저 화면은 보안 프로그램이 직접 통제하기 어렵습니다.

PlaynPlay는 웹 페이지가 PlaynPlay App을 실행해 DRM 패키징 파일을 재생하므로 브라우저 플러그인을 쓰지 않습니다. 방식별 위험과 공식 근거는 레거시 보안 플레이어의 위험성에 있습니다.

Feature Mapping

기존 플레이어 기능 → PlaynPlay에서의 대응

전환 회의에서 가장 많이 나오는 질문은 "지금 쓰는 그 기능은 어떻게 되나요"입니다. 개발 문서로 확인되는 대응만 적었습니다.

기존 기능PlaynPlay 대응설정 위치
플러그인 설치 후 재생웹 페이지에서 PlaynPlay App(Windows 10 이상, macOS 11 이상)을 실행해 재생agent.js, playnplay.launch()
캡처 프로그램 차단PlaynPlay App과 Android·iOS SDK의 녹화 차단콘솔 녹화 차단 관리
사용자 ID 워터마크PlaynPlay App과 Android SDK의 워터마크콘솔 보안·워터마크 관리
중복 접속·기기 제한동시 접속 감지, 기기 제한 초과 처리. 고객사 서버가 기기 제한 초과로 응답할 수도 있음콘솔 디바이스 관리, CheckAccessRights
수강 기간 확인라이선스 발급 때 허용·만료·권한 없음을 판단하고 접근 만료 일시를 전달CheckAccessRights
진도 체크 스크립트콘솔에 정한 주기마다 재생 위치, 재생 시간, 시청 시간을 보고NotifyPlaybackProgress
건너뛰기·배속 금지영상마다 탐색 허용 여부와 배속 허용 여부 지정MediaItem의 seekable, disablePlaybackRate
이어보기재생 시작 시간 지정. syncedAt를 함께 주면 오프라인에 저장된 최근 재생 시간과 비교해 더 최근 값 사용MediaItem의 startTime
북마크PlaynPlay 저장 방식과 고객사 DB 콜백 방식 중 선택useBookmarkCallback
다운로드 수강다운로드 실행, 오프라인 재생 기한, 오프라인 시청 기록의 사후 전송playnplay.download(), NotifyOfflinePlaybackLog
전용 보안 학습 창고객사 웹 페이지를 PlaynPlay App 안에서 여는 커스텀 페이지LaunchType.OpeningPage

각 연동 방식의 구성은 개발자 안내, 낯선 용어는 용어집에서 확인하세요.

Phases

네 단계로 범위를 넓혀 가며 옮깁니다

모든 과정을 하루에 바꾸면 문제가 생겼을 때 되돌릴 길이 없습니다. 학습 기록을 잃지 않는 순서로 나눠 진행하기를 권합니다.

  1. 현황 조사

    레거시 플레이어가 붙은 과정, 원본 영상 위치, 진도·북마크가 저장된 테이블을 목록으로 만듭니다. 학습자 PC 환경은 agent.js의 getDeviceInfo()로 플랫폼, 버전, 아키텍처, 모델을 모아 지원 범위 밖 사용자를 미리 찾습니다.

  2. 파일럿

    과정 하나를 골라 DRM 패키징, 업로드, Callback URL 연결까지 끝냅니다. 내부 테스트 계정과 일부 학습자로 PC·모바일 재생, 진도 반영, 권한 거절을 시험합니다.

  3. 병행 운영

    과정마다 기존 플레이어와 PlaynPlay 중 무엇으로 열지 LMS에서 고를 수 있게 둡니다. 두 플레이어가 같은 진도 테이블에 기록하면 학습자가 중간에 옮겨 와도 기록이 이어집니다.

  4. 전환

    재생 버튼을 PlaynPlay로 바꾸고 레거시 설치 안내를 내립니다. playnplay_config.js의 minVersion으로 최소 버전을 정해 오래된 PlaynPlay App에 업데이트 알림이 가게 합니다. 레거시 프로그램 배포는 안정화를 확인한 뒤 중단합니다.

콘솔 설정부터 오픈 전 테스트까지의 상세 순서는 도입 실행 가이드, 영상 파일 준비는 콘텐츠 패키징 가이드를 참고하세요.

Learner Notice

학습자에게 미리 알릴 것

학습자에게 달라지는 것은 설치 프로그램과 재생 창입니다. 공지문과 고객센터 답변을 같은 내용으로 준비하세요.

  • 설치

    PlaynPlay App 하나를 설치합니다

    PC 학습자는 별도 설치 파일로 제공되는 PlaynPlay App을 설치합니다. Windows 10 이상, macOS 11 이상이 대상입니다. 기존 플러그인이나 프록시 프로그램을 지우는 방법도 같은 공지에 넣으세요.

    PC 재생 흐름 보기
  • 재생 창

    재생 버튼을 누르면 앱 창이 열립니다

    강의실 화면은 그대로이고, 재생 버튼을 누르면 PlaynPlay App의 플레이어가 실행됩니다. 플레이어 창의 너비와 높이는 고객사가 정합니다. 공지에 바뀐 화면 캡처를 넣어 두면 문의가 줄어듭니다.

  • 업데이트

    업데이트 알림이 뜰 수 있습니다

    고객사가 정한 최소 버전보다 낮은 PlaynPlay App에는 업데이트 알림이 갑니다. 알림이 뜨면 업데이트 후 다시 재생하라는 문장을 공지와 상담 답변에 넣어 두세요.

  • 오류 안내

    막힌 이유를 원인별로 답합니다

    커스텀 페이지는 라이선스 없음, 동시 접속, 기기 제한 초과, 접근 권한 만료, 재생 제한 초과처럼 원인이 구분된 세션 오류를 받습니다. 접근 권한 검사는 고객사 서버가 답하므로, 응답 기록을 남겨 두면 상담원이 거절 이유를 바로 찾을 수 있습니다.

Data Continuity

진도·이어보기·북마크를 끊기지 않게 옮기기

학습 기록은 기존 LMS 데이터베이스에 그대로 둡니다. PlaynPlay는 Callback URL로 기록을 보내고 받기 때문에 저장 위치를 옮길 필요가 없습니다.

데이터옮기는 방법확인할 점
학습자·과정 식별기존 회원 ID를 userId로, 과정·차시 ID는 userData에 담아 재생 요청에 넣습니다모든 콜백에 userId와 userData가 함께 옵니다
진도율기존 진도 테이블을 유지하고 NotifyPlaybackProgress의 값으로 이어서 누적합니다위치·길이는 밀리초입니다. 2배속으로 1초 보면 재생 시간 2초, 시청 시간 1초입니다
완강 판정NotifyPlaybackFinish의 종료 원인(Ended, Error, UserExited)을 기존 완강 규칙에 연결합니다오프라인 시청분은 온라인 연결 뒤 NotifyOfflinePlaybackLog로 도착합니다
이어보기 위치기존 마지막 위치를 MediaItem의 startTime 값으로 넘깁니다단위는 초입니다. syncedAt를 함께 주면 기기에 저장된 최근 위치와 비교합니다
북마크useBookmarkCallback을 켜고 기존 북마크를 GetBookmarks 응답으로 돌려줍니다. 변경분은 UpdateBookmarks로 받습니다위치(pos)는 초 단위이고, 제목이 없으면 Untitled로 표시됩니다

진도율 계산 기준은 진도 데이터 설계 가이드, 콜백 형식은 Callback URL 문서에 있습니다.

전환 전에 확인할 위험

  • 지원 범위 밖 PC를 쓰는 학습자가 있다면?

    PlaynPlay App은 Windows 10 이상, macOS 11 이상에서 동작합니다. 현황 조사에서 해당 학습자를 먼저 찾고, 모바일 앱 수강 같은 대체 경로를 전환 공지 전에 정해 두세요.

  • 회사 PC에 프로그램 설치가 막혀 있다면?

    기업 교육은 PC 보안 정책 때문에 설치 승인이 필요할 수 있습니다. 파일럿 전에 고객사 IT 부서에 PlaynPlay App 설치 승인을 요청해 두세요.

  • 진도 보고 횟수로 시청 시간을 계산해도 되나요?

    권하지 않습니다. Android·iOS SDK는 2026년 8월부터 진행 상태에 변화가 없으면 NotifyPlaybackProgress 호출을 생략합니다. 호출 횟수 대신 보고에 담긴 위치와 시청 시간으로 계산하세요.

  • 서버 응답 하나로 정상 학습자가 막힐 수 있나요?

    있습니다. 진행 상태 보고에 PlaybackLimitExceeded로 답하면 재생 제한 초과로 처리되고, 접근 권한 검사에서 거절하면 라이선스가 나가지 않습니다. 기존 규칙과 같은 기준인지 파일럿에서 경계값까지 시험하고, 전환일에는 Callback 서버를 지켜볼 담당자를 정하세요.

  • 레거시 학습 화면의 팝업 창은 어떻게 되나요?

    PlaynPlay App 1.0.31(2025년 12월)부터 커스텀 페이지의 window.open은 앱 안의 새 창으로 열립니다. 외부 브라우저로 열 링크는 target에 _external을 지정해야 합니다. 퀴즈·설문 팝업을 쓰던 과정은 파일럿에서 확인하세요.

Get Started

PlaynPlay 도입을 위한
기술적 지원과 서비스를 제공합니다.

제품 문의부터 데모 시연까지, 모든 지원을 위해 세일즈 및 기술 지원 팀이 준비되어 있습니다.

  • 제품 및 도입 문의

    도입 범위, 일정, 견적을 상담합니다. 서비스 형태와 사용자 규모를 알려주시면 맞는 연동 방식과 보안 설정을 제안합니다.

  • Trial 신청

    PlaynPlay의 기능을 먼저 테스트해 보세요. 트라이얼 기간 동안 귀사의 제품과 PlaynPlay를 연동하고 성능과 기능을 직접 검증할 수 있습니다.

  • PlaynPlay 기술 문의

    SDK 연동, Callback URL 설계, DRM 패키징 중에 생기는 질문에 기술팀이 답합니다. 공개된 개발 문서와 샘플 프로젝트도 함께 확인하세요.