VPE Core SDK

VPE Player를 초기화하고 설정을 검증하는 Core SDK입니다. Access Key 검증, 서버 옵션 동기화, MA 리포트 동기화, 다국어 메시지, 옵션 정규화를 제공합니다.

주요 기능

• Access Key 및 App ID 기반 라이선스/설정 확인
• 플랫폼/스테이지별 서버 설정 로딩 (pub|gov, prod|beta)
• 플레이어 옵션 병합 및 검증
• 무료 요금제 강제 옵션 템플릿 적용
• MA(통계/리포트) 동기화 및 전송
• i18n 문자열 조회 ($t)
• HLS 마스터 플레이리스트 파싱

설치

pnpm install

기본 사용법

import VpeCore from '@sgrsoft/vpe-core-sdk';

const vpe = new VpeCore({
	accessKey: 'YOUR_ACCESS_KEY',
	appId: location.origin,
	platform: 'pub',
	stage: 'prod',
	isDev: false,
});

const result = await vpe.initialize();
if (result.error) {
	console.error(result.error);
	return;
}

const options = vpe.getValidatedOptions({
	autostart: false,
});
console.log(options);

API 요약

VpeCore 생성자

• accessKey: 인증 키
• appId: 앱/도메인 식별자
• platform: pub 또는 gov
• stage: prod 또는 beta
• isDev: 개발 모드일 때 true
• language: i18n 언어 코드

주요 메서드

• initialize(): 서버 설정과 MA 초기화 수행
• isInitialized(): 서버 설정 로딩 여부
• isPaidTier(): 요금제 유료 여부
• getValidatedOptions(options): 서버 옵션과 로컬 옵션 병합
• $t(key): i18n 문자열 조회
• getErrorState(): 마지막 에러 상태 반환
• hlsPaser(url): HLS 마스터 플레이리스트 파싱

예제

• example/ 디렉터리의 최소 연동 샘플로 동작 확인
• 실행: pnpm dev

빌드

pnpm build
pnpm build:types

배포 산출물

dist/에 다음 파일만 배포 대상으로 유지합니다.

• vpe-core-sdk.es.js
• vpe-core-sdk.cjs.js
• main.d.ts