Pellio 작동 방식

테스터와 Pellio를 검토하는 분들을 위해 Pellio가 어떻게 구성되어 있는지 정리한 개요입니다. Pellio를 사용하는 데 꼭 알아야 하는 내용은 아니지만, 무언가가 예상대로 작동하지 않을 때 도움이 됩니다.

구성 요소

구성 요소	위치	역할
대시보드	pellio.io/app	나와 팀이 동영상을 업로드, 정리, 설정하고 분석과 학습자 기록을 확인하는 곳입니다.
API	api.pellio.io	대시보드가 하는 모든 일을 직접 작성한 코드에서도 할 수 있게 합니다(API 키). 웹훅을 보내고 학습자 이벤트를 LRS로 전달하는 역할도 합니다.
플레이어	play.pellio.io	임베드할 수 있는 플레이어와 공유 페이지입니다. 요청이 올 때마다 그곳에서 동영상을 재생해도 되는지 판단하고, 시청한 내용을 보고합니다.
저장과 처리	API 뒤편	원본 파일을 보관하고, 업로드된 파일을 적응형 스트림(최대 1080p), 썸네일, 탐색 미리보기 스트립, 짧은 미리보기 클립으로 변환합니다.
WordPress 플러그인	내 사이트	WordPress 사이트를 워크스페이스에 연결합니다. 블록과 쇼트코드를 추가하고, 임베드마다 해당 페이지용 서명을 붙이고, Pellio를 LMS 및 멤버십 플러그인과 연결합니다.

업로드에서 시청자까지

1. 업로드. 브라우저가 파일을 여러 조각으로 나눠 병렬로 저장소에 바로 보내므로, 큰 파일도 빠르게 업로드되고 이어서 올릴 수 있습니다. 파일은 대시보드나 API를 거치지 않습니다.
2. 처리. Pellio가 적응형 스트리밍을 위해 동영상을 여러 화질로 변환하고 썸네일과 미리보기를 만듭니다. 동영상을 교체하면 새 버전도 같은 과정을 거치며 링크는 그대로 유지됩니다.
3. 재생. 플레이어가 짧은 시간 동안만 유효한 재생 토큰을 요청한 다음, 만료되는 링크로 저장소에서 스트리밍합니다. 페이지에서 스트림 링크를 복사해도 계속 접근할 수는 없습니다.

시청할 수 있는 사람

플레이어가 로드될 때마다 Pellio는 다음 항목을 순서대로 확인합니다. 처음으로 해당되는 항목이 결과를 결정합니다.

1. 대시보드의 내 미리보기는 항상 재생됩니다.
2. 국가: 시청자가 있는 곳에서 동영상이 차단되어 있으면 재생되지 않습니다.
3. 공유 링크는 동영상이 비공개이거나 비밀번호가 있어도 링크가 만료되거나 비활성화될 때까지 재생됩니다.
4. 연결된 WordPress 사이트가 서명한 임베드는 재생됩니다. 사이트가 페이지와 로그인한 사용자별로 임베드에 서명하므로, 임베드 코드를 다른 곳에 복사하면 작동하지 않습니다.
5. 비공개 동영상은 여기서 멈춥니다.
6. Only play on my allowed domains가 켜져 있으면, 동영상을 임베드한 페이지가 허용 목록에 있어야 합니다.
7. 시청자 비밀번호가 설정되어 있으면 마지막으로 비밀번호를 묻습니다.

설정 방법은 공개 범위와 접근 권한을 참고하세요.

시청 측정 방식

플레이어는 재생 위치가 어디까지 갔는지가 아니라, 동영상의 어느 초가 실제로 재생되었는지를 기록합니다. 앞으로 건너뛴 부분은 시청으로 인정되지 않고, 다시 본 부분은 두 번 집계되지 않습니다. 이 데이터가 다음 기능의 바탕이 됩니다.

• 분석: 재생 수, 순 시청자 수, 시청 시간, 시청 지속률, 히트맵. 익명 시청에는 쿠키를 사용하지 않습니다. 분석
• 식별된 시청자: 연결된 WordPress 사이트에 로그인한 사용자와 이메일을 제공한 시청자(양식에 입력했거나 사이트가 공유한 경우)는 동영상의 Viewers 탭에 이름으로 표시됩니다.
• 코스를 위한 확인된 시청: 레슨에 동영상 시청이 필수이면, WordPress 플러그인이 해당 수강생이 고유하게 시청한 초가 얼마인지 Pellio에 확인한 뒤에야 레슨을 완료할 수 있게 합니다. 브라우저가 시청했다고 주장하는 것만으로는 완료되지 않습니다.

학습자 기록

Pellio는 식별된 학습자의 모든 마일스톤을 기록합니다. 동영상을 얼마나 시청했는지와 함께, WordPress 사이트가 보낸 레슨 확인, 완료, 다시 열린 레슨, 확인 서명이 기록됩니다. 각 항목에는 바로 앞 항목의 지문(SHA-256 해시)이 포함됩니다. 어떤 항목이든 변경, 삭제하거나 순서를 바꾸면 그 이후의 모든 지문이 깨지며, Verify again을 누르면 어디서 깨졌는지 보여 줍니다. 데이터베이스도 한 번 기록된 항목의 변경을 거부합니다. 항목은 내보낼 수 있고, xAPI 문(statement)으로 LRS에 보낼 수도 있습니다. 컴플라이언스 교육

레슨 하나가 처음부터 끝까지 진행되는 모습

1. 수강생이 LifterLMS 레슨을 엽니다. 플러그인이 해당 수강생용으로 서명한 임베드와 함께 Pellio 플레이어를 표시합니다.
2. 수강생이 시청하는 동안 플레이어가 재생한 초를 보고합니다. Pellio는 이를 해당 수강생이 어떤 기기에서든 이전에 시청한 기록에 더합니다.
3. 충분히 시청하면(기본값 90%) 플러그인이 Pellio에 확인합니다. watch verified(시청 확인됨)를 기록하고, 레슨에 확인 서명이 있으면 이를 표시한 뒤 레슨을 완료합니다.
4. 모든 단계가 학습자 기록에 추가됩니다. 코스의 증빙 CSV, 주간 진행 보고서, LRS 모두 같은 기록을 읽습니다.