Electron 문서1.4.1

Docs / Tutorial / Widevine CDM 플러그인 사용하기

Widevine CDM 플러그인 사용하기

Electron에선 Chrome 브라우저에서 취득해온 Widevine CDM 플러그인을 사용할 수 있습니다.

플러그인 취득

Electron은 라이센스상의 문제로 Widevine CDM 플러그인을 직접 제공하지 않습니다. 따라서 플러그인을 얻으려면 먼저 사용할 Electron 빌드의 아키텍쳐와 버전에 맞춰 공식 Chrome 브라우저를 설치해야 합니다.

참고: Chrome 브라우저의 메이저 버전은 Electron에서 사용하는 Chrome 버전과 같습니다, 만약 그렇지 않다면 navigator.plugins가 로드됐더라도 정상적으로 작동하지 않습니다.

Windows & macOS

Chrome 브라우저에서 chrome://components/를 열고 WidevineCdm을 찾은 후 확실히 최신버전인지 확인합니다. 여기까지 하면 모든 플러그인 바이너리를 APP_DATA/Google/Chrome/WidevineCDM/VERSION/_platform_specific/PLATFORM_ARCH/ 디렉터리에서 찾을 수 있습니다.

APP_DATA는 애플리케이션 데이터를 저장하고 있는 시스템 경로입니다. Windows에선 %LOCALAPPDATA%로 접근할 수 있고 macOS에선 ~/Library/Application Support로 접근할 수 있습니다. VERSION1.4.8.866 같은 Widevine CDM 플러그인의 버전 문자열입니다. PLATFORM은 플랫폼을 뜻하며 mac 또는 win이 될 수 있으며 ARCH는 아키텍쳐를 뜻하고 x86 또는 x64가 될 수 있습니다.

Windows에선 widevinecdm.dllwidevinecdmadapter.dll 같은 바이너리를 요구하며 macOS에선 libwidevinecdm.dylibwidevinecdmadapter.plugin 바이너리를 요구합니다. 원하는 곳에 이들을 복사해 놓을 수 있습니다. 하지만 반드시 바이너리는 같은 위치에 두어야 합니다.

Linux

Linux에선 플러그인 바이너리들이 Chrome 브라우저와 함께 제공됩니다. /opt/google/chrome 경로에서 찾을 수 있으며, 파일 이름은 libwidevinecdm.solibwidevinecdmadapter.so입니다.

플러그인 사용

플러그인 파일을 가져온 후, Electron의 --widevine-cdm-path 커맨드 라인 스위치에 widevinecdmadapter의 위치를 전달하고 플러그인의 버전을 --widevine-cdm-version 스위치에 전달해야 합니다.

참고: widevinecdmadapter 바이너리가 Electron으로 전달되어도, widevinecdm 바이너리는 옆에 같이 두어야 합니다.

커맨드 라인 스위치들은 app 모듈의 ready 이벤트가 발생하기 전에 전달되어야 합니다. 그리고 이 플러그인을 사용하는 페이지는 플러그인(속성)이 활성화되어있어야 합니다.

예시 코드:

// `widevinecdmadapter`의 파일 이름을 이곳에 전달해야 합니다. 파일 이름은
// * macOS에선 `widevinecdmadapter.plugin`로 지정합니다,
// * Linux에선 `libwidevinecdmadapter.so`로 지정합니다,
// * Windows에선 `widevinecdmadapter.dll`로 지정합니다.
app.commandLine.appendSwitch('widevine-cdm-path', '/path/to/widevinecdmadapter.plugin')
// 플러그인의 버전은 크롬의 `chrome://plugins` 페이지에서 취득할 수 있습니다.
app.commandLine.appendSwitch('widevine-cdm-version', '1.4.8.866')

let win = null
app.on('ready', () => {
  win = new BrowserWindow({
    webPreferences: {
      // `plugins`은 활성화되어야 합니다.
      plugins: true
    }
  })
})

플러그인 작동 확인

플러그인 정상적으로 작동하는지 확인하려면 다음과 같은 방법을 사용할 수 있습니다:


고쳐야 할 것이 있습니까? 소스에서 변경을 제안할 수 있습니다.
다른 버전의 문서가 필요한가요? 이전 버전 또는 커뮤니티 번역을 보세요.
모든 문서를 한번에 검색하고 싶으신가요? 한 페이지 문서를 보세요.