Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
title릴리즈 3.1.0 이상

'editor.upload.video.embedURLTransformers'에 도메인을 등록하면 해당 URL의 비디오를 업로드할 때 iframe으로 생성됩니다.

Code Block
languagejs
titlesynapeditor.config.js
'editor.upload.video.embedURLTransformers': {
    'youtube.com': {
        pathParts: ['shorts', 'live'],
        parameter: 'v',
        embedTemplate: 'https://youtube.com/embed/{id}'
    },
    'youtu.be': {
        pathParts: [''],
        embedTemplate: 'https://youtube.com/embed/{id}'
    },
    'tv.naver.com': {
        pathParts: ['v'],
        embedTemplate: 'https://tv.naver.com/embed/{id}'
    },
    'tv.kakao.com': {
        pathParts: ['v', 'cliplink'],
        embedTemplate: 'https://play-tv.kakao.com/embed/player/cliplink/{id}'
    },
    'play-tv.kakao.com': {
        pathParts: ['v', 'cliplink'],
        embedTemplate: 'https://play-tv.kakao.com/embed/player/cliplink/{id}'
    },
    'chzzk.naver.com': {
        pathParts: ['clips'],
        embedTemplate: 'https://chzzk.naver.com/embed/clip/{id}'
    },
    'vod.sooplive.co.kr': {
        pathParts: ['player'],
        embedTemplate: 'https://vod.sooplive.co.kr/player/{id}/embed'
    },
    'vimeo.com': {
        pathParts: [''],
        embedTemplate: 'https://player.vimeo.com/video/{id}'
    },
    'player.vimeo.com': {}
}


구성설명예시
pathParts

URL에서 ID 앞에 위치한 경로(Path)를 나타냅니다.

parameter

URL에서 ID가 특정 키의 값으로 설정된 파라미터를 의미합니다.

embedTemplate

URL을 embed 형태로 변환하기 위한 템플릿입니다.

  • embedTemplate: 'https://youtube.com/embed/{id}' - ID를 이용해 embed 형태의 YouTube URL로 변환.
Note

embedTemplate 형태로 URL을 변환할 때 기존 Domain과 변환된 URL의 Domain이 달라질 경우,

editor.upload.video.embedURLTransformers에 새로운 Domain을 등록해야 비디오를 iframe으로 생성이 가능합니다.

ex)

Code Block
languagejs
titlesynapeditor.config.js
'editor.upload.video.embedURLTransformers': {
    'vimeo.com': {
        pathParts: [''],
        embedTemplate: 'https://player.vimeo.com/video/{id}'
    },
    'player.vimeo.com': {}
}

https://vimeo.com/956202369 URL을 https://player.vimeo.com/video/956202369로 변환했을 때, 도메인이 vimeo.com에서 player.vimeo.com으로 변경됩니다.

이 경우, player.vimeo.com을 editor.upload.video.embedURLTransformers에 등록해야 iframe으로 생성됩니다.