포함된 플레이어 상호 작용 API 설명서

Adobe Learning Manager는 앱에 통합할 수 있는 라이브러리를 제공합니다. 이 라이브러리는 포함된 플레이어에서 이벤트를 수신하고 동작을 트리거하기 위한 다양한 API를 제공합니다.

제공된 API를 사용하여 플레이어에서 재생, 일시 정지 및 기타 동작을 수행할 수 있습니다.

라이브러리 로드

라이브러리는 이 위치에서 사용할 수 있습니다.

라이브러리를 로드하려면 아래의 단계를 따르십시오.

  1. 소비자 응용 프로그램에서 js 파일을 로드합니다.
  2. 라이브러리를 로드하면 window.cpPlayerLib가 채워집니다.
NOTE
prod US를 사용하지 않는 경우 env를 기준으로 cpPlayerLib.env 및 cpPlayerLib.sourceOrigin 매개 변수를 설정합니다.

기본값은 다음과 같습니다.

사용 가능한 메서드

cpPlayerLib 라이브러리는 다음 함수로 구성됩니다.

startPlayer

메서드 이름
startPlayer
설명
앱에서 플레이어를 로드합니다.
매개 변수
  • loId : 학습 객체 ID입니다.

  • accountId : ALM 계정의 계정 ID입니다.

  • userId : 사용자 ID입니다.

  • accessToken : 액세스 토큰입니다.

  • domRefId: 플레이어를 렌더링해야 하는 div 컨테이너의 ID입니다.

  • onModuleLoaded: 이 함수는 아래 세부 정보가 있는 모듈이 로드될 때 호출됩니다.

  • contentType

  • loId

  • moduleId

  • completed

  • currentLanguage

  • availableLanguages

  • isCCAvailable

  • ccEnabled

반환
약속을 반환합니다. 이 약속이 해결되면 playerObj가 전달됩니다.
예외
약속은 예외로 귀착됩니다.
샘플 코드
cpPlayerLib.startPlayer(loId, accountId, userId, accessToken, domRefId, onModuleLoaded).then((playerObj) => {//playerObj에는 플레이어와 상호 작용할 API가 있음}) >

getAllPlays

메서드 이름
getAllPlayers
설명
현재 페이지의 모든 플레이어 개체를 반환합니다.
매개 변수
없음
샘플 코드
cpPlayerLib.getAllPlayers()

getPlayer

메서드 이름
getPlayer
설명
지정된 학습 개체 ID의 플레이어 개체를 반환합니다.
매개 변수
  • loId : 학습 객체 ID입니다.
샘플 코드
cpPlayerLib.getPlayer(loId)

navigateToModule

메서드 이름
navigateToModule
설명
다음 모듈로 이동합니다.
매개 변수
  • moduleId: 모듈 ID.
샘플 코드
playerObj.navigateToModule(moduleID)

다음

메서드 이름
next
설명
다음 모듈로 이동합니다.
매개 변수
  • 없음
샘플 코드
playerObj.next()

이전

메서드 이름
previous
설명
이전 모듈로 이동합니다.
매개 변수
  • 없음
샘플 코드
playerObj.previous()

toggleTOC

메서드 이름
toggleTOC
설명
플레이어에서 목차 패널을 전환합니다.
매개 변수
  • 없음
샘플 코드
playerObj.toggleTOC()

toggleNotes

메서드 이름
toggleNotes
설명
플레이어에서 노트 패널을 전환합니다.
매개 변수
  • 없음
샘플 코드
playerObj.toggleNotes()

toggleClosedCaption

메서드 이름
toggleClosedCaption
설명
플레이어에서 폐쇄 자막 표시를 토글합니다.
매개 변수
  • 없음
샘플 코드
playerObj.toggleClosedCaption()

언어 변경

메서드 이름
changeLanguage
설명
플레이어에서 콘텐츠 언어를 변경합니다.
매개 변수
  • language: 지정할 언어 코드입니다.
샘플 코드
playerObj.changeLanguage("es")

closePlayer

메서드 이름
closePlayer
설명
플레이어를 닫고 페이지에서 플레이어를 제거합니다.
매개 변수
  • 없음
샘플 코드
playerObj.closePlayer()

재생 일시 중지

메서드 이름
togglePlayPause
설명
플레이어에서 콘텐츠 재생 및 일시 중지 간에 전환합니다.
매개 변수
  • 없음
샘플 코드
playerObj.togglePlayPause()

setVolume

메서드 이름
setVolume
설명
플레이어 볼륨을 설정합니다. 값은 0에서 1 사이여야 합니다.
매개 변수
  • volume: 볼륨의 값입니다. 유효한 범위는 0-1입니다.
샘플 코드
playerObj.setVolume(0.5)

setPlayBackSpeed

메서드 이름
setPlayBackSpeed
설명
플레이어에서 재생 속도를 설정합니다.
매개 변수
  • speed: 지정할 속도 값입니다. 유효한 값은 .25, .5, .75, 1, 1.25, 1.5, 1.75, 2입니다.
샘플 코드
playerObj.setPlayBackSpeed(1.25)

탐색

메서드 이름
seek
설명
비디오의 원하는 시간으로 이동합니다.
매개 변수
  • time: 이동할 시간입니다. 시간은 초 단위입니다.
샘플 코드
playerObj.seek(50)

앞으로

메서드 이름
forward
설명
비디오를 10초 앞으로 이동합니다.
매개 변수
  • 없음
샘플 코드
playerObj.forward()

뒤로

메서드 이름
backward
설명
비디오를 10초 뒤로 이동합니다.
매개 변수
  • 없음
샘플 코드
playerObj.backward()

navigateToPage

메서드 이름
navigateToPage
설명
PPT/PDF에서 지정된 페이지로 이동합니다.
매개 변수
  • pageNumber: 이동할 페이지 번호입니다.
샘플 코드
playerObj.navigateToPage (5)

다음 페이지

메서드 이름
nextPage
설명
PPT/PDF에서 다음 페이지로 이동합니다.
매개 변수
  • 없음
샘플 코드
playerObj.nextPage()

previousPage

메서드 이름
previousPage
설명
PPT/PDF에서 이전 페이지로 이동합니다.
매개 변수
  • 없음
샘플 코드
playerObj.previousPage()

확대

메서드 이름
zoomIn
설명
PPT/PDF에서 콘텐츠를 확대합니다.
매개 변수
  • 없음
샘플 코드
playerObj.zoomIn()

축소

메서드 이름
zoomOut
설명
PPT/PDF에서 콘텐츠를 축소합니다.
매개 변수
  • 없음
샘플 코드
playerObj.zoomOut()

다운로드 작업 지원

메서드 이름
downloadJobAid
설명
강의에서 작업 지원을 다운로드합니다.
매개 변수
  • 없음
샘플 코드
playerObj.downloadJobAid()

JobAidPullout

메서드 이름
toggleJobAidPullout
설명
작업 지원을 다운로드할 것인지 여부입니다.
매개 변수
  • 없음
샘플 코드
playerObj.toggleJobAidPullout()

전체 화면

메서드 이름
fullScreen
설명
플레이어를 전체 화면 모드로 설정합니다.
매개 변수
  • 없음
샘플 코드
playerObj.fullScreen()

이벤트 목록

onPlayerEvents(callBack)

콜백 함수를 등록하면 모든 플레이어 이벤트에서 호출됩니다. 이벤트 이름은 다음과 같습니다.

  • PLAY(비디오/오디오/CP)
  • PAUSE(비디오/오디오/CP)
  • TIMEUPDATE(비디오/오디오/CP)
  • PAGECHANGE(PPT/PDF)
  • NOTEADDED(모든 콘텐츠)
  • LAUNCHED(모든 콘텐츠)
  • STARTED(모든 콘텐츠)
  • COMPLETED(모든 콘텐츠)
  • PASSED(모든 콘텐츠)
  • FAILED(모든 콘텐츠)

onStreamingEvents(callBack)

콜백 함수를 등록하면 사용자 활동을 추적하기 위해 전송되는 모든 플레이어 명령문에 대해 호출됩니다.

recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d