Page History

Status


title	릴리즈 3.1.0 2501 이상

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

다음은 기본적으로 지원하는 Domain 설정으로 이외에는 비디오 태그로 생성됩니다.

Code Block

language	js
title	synapeditor.config.js
collapse	true

'editor.upload.video.embedURLTransformers': {
    'youtube.com': {
        pathParts: [{
            'shorts',: 'live'],https://www.youtube.com/embed/{id}',
           parameter 'live': 'v'https://www.youtube.com/embed/{id}',
            },
        embedTemplateparameters: {
            'v': 'https://www.youtube.com/embed/{id}'
        }
    },
    'youtu.be': {
        pathParts: [''],{
            embedTemplate'': 'https://www.youtube.com/embed/{id}'
        }
    },
    'tv.naver.com': {
        pathParts: ['v'] {
            'v': 'https://tv.naver.com/embed/{id}',
        embedTemplate    'h': 'https://tv.naver.com/embed/{id}'
        }
    },
    'tv.kakao.com': {
        pathParts: {
            'livelink': ['v', 'cliplink']'https://play-tv.kakao.com/embed/player/livelink/{id}',
            'cliplink': 'https://play-tv.kakao.com/embed/player/cliplink/{id}',
        embedTemplate    'v': 'https://play-tv.kakao.com/embed/player/cliplink/{id}'
        }
    },
    'play-tv.kakao.com': {
        pathParts: {
            'livelink': ['v', 'cliplink']'https://play-tv.kakao.com/embed/player/livelink/{id}',
            'cliplink': 'https://play-tv.kakao.com/embed/player/cliplink/{id}',
        embedTemplate    'v': 'https://play-tv.kakao.com/embed/player/cliplink/{id}'
        },
    },
    'chzzk.naver.com': {
        pathParts: ['clips'],{
            embedTemplate'clips': 'https://chzzk.naver.com/embed/clip/{id}'
        }
    },
    'vod.sooplive.co.kr': {
        pathParts: ['player'] {
            'player': 'https://vod.sooplive.co.kr/player/{id}/embed'
        }
    },
    'play.sooplive.co.kr': {
     embedTemplate   pathParts: {
            '': 'https://vodplay.sooplive.co.kr/player/{id}/embed'
        }
    },
    'vimeo.com': {
        pathParts: [''],{
            embedTemplate'': 'https://player.vimeo.com/video/{id}'
        }
    },
    'player.vimeo.com': {
        pathParts: {
            'video': 'https://player.vimeo.com/video/{id}'
        }
    },
}

pathParts: [''] // Domain 바로 뒤에 ID가 있는 경우입니다.

구성

설명

예시

pathParts

URL에서 ID 앞에 위치한

Path입니다.

경로(Path)를 설정합니다.
해당 경로가 있는 경우 변환할 embedTemplate 설정합니다.

Code Block
'youtu.be': { pathParts: { '': 'https://www.youtube.com/embed/{id}' // 도메인 바로 뒤에 ID가 있는 경우 } }

https://youtu.be/-VI9Jp5807s → https://www.youtube.com/embed/-VI9Jp5807s

Code Block
'youtube.com': { pathParts

: ['v', 'cliplink'] // ID가 '/v' 혹은 '/cliplink' Path 뒤에 있는 경우입니다.
'https://tv.kakao.com/v/450845944', 'https://tv.kakao.com/channel/1615/cliplink/450926200'

parameter

URL에서 ID가 키 값으로 설정된 Parameter 키입니다.

parameter: 'v' // ID가 파라미터에서 'v' 키의 값으로 설정된 경우입니다.
'

: {
        'shorts': 'https://www.youtube.com/embed/{id}', // ID가 'shorts' 뒤에 있는 경우
        'live': 'https://www.youtube.com/embed/{id}'  // ID가 'live' 뒤에 있는 경우
    }
}

parameter

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

해당 키가 있는 경우 변환할 embedTemplate 설정합니다.

Code Block
'youtube.com': { parameters: { 'v': 'https://www.youtube.com/embed/{id}' // ID가 파라미터 v의 값으로 설정된 경우 } }

https://www.youtube.com/watch?v=-VI9Jp5807s

'

→ https://www.youtube.com/embed/-VI9Jp5807s

embedTemplate

URL을 embed 형태로

바꾸기

변환하기 위한 템플릿입니다.

embedTemplate: 'https://youtube.com/embed/{id}'

// id를 이용해 embed형태의 유튜브 URL로 변환하기 위한 템플릿입니다.

- ID를 이용해 embed 형태의 YouTube URL로 변환

Note

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

'editor.upload.video.embedURLTransformers'에 등록되어있지 않는 Domain은 ifame으로 생성하지 않으므로 해당 Domain도 반드시 등록해주어야 합니다embedURLTransformers에 새로운 Domain을 등록해야 비디오를 iframe으로 생성할 수 있습니다.

ex)

Code Block

language	js
title	synapeditor.config.js

'editor.upload.video.embedURLTransformers': {
    'youtu.be': {
        pathParts: {
            '': 'https://www.youtube.com/embed/{
    'vimeoid}'
        }
    },
    'youtube.com': {
            pathParts: [''],
        embedTemplate{
            'shorts': 'https://www.youtube.com/embed/{id}',
            'live': 'https://playerwww.vimeoyoutube.com/videoembed/{id}'
   ,
        },
    'player.vimeo.com': {
        parameters: {
            'v': 'https://www.youtube.com/embed/{id}'
        }
    }
}

'

https://

vimeo

youtu.

com/956202369' URL을 '

be/-VI9Jp5807s URL을 https://

player

www.

vimeo

youtube.com/

video

embed/

956202369'

-VI9Jp5807s로 변환했을 때

'vimeo.com' 도메인이 'player.vimeo.com'으로 바뀌었으므로
'player.vimeo.com'를 위 처럼 '

, 도메인이 youtu.be에서 youtube.com으로 변경됩니다.

이 경우, youtube.com을 editor.upload.video.

embedURLTransformers'에 등록해주어야

embedURLTransformers에 등록해야 iframe으로 생성됩니다.

원본 URL	변환된 URL	미리보기
https://tvyoutu.naver.com/v/67134646Image Removedbe/-VI9Jp5807s Image Added	https://tvwww.naveryoutube.com/embed/67134646-VI9Jp5807s Image RemovedImage AddedImage Removed	Image Added

Space shortcuts

Page tree

Versions Compared

Old Version 2

New Version Current

Key