📢 광고 시스템

Pre-roll (재생 전), Mid-roll (중간 광고) 광고를 지원합니다. 이미지 광고와 비디오 광고 모두 사용 가능하며, 스킵 기능도 제공합니다.

  • Pre-roll: 이미지 광고 (5초, 3초 후 스킵 가능)
  • Mid-roll (15초): 비디오 광고 (스킵 불가)
  • Mid-roll (30초): 이미지 광고 (7초, 4초 후 스킵 가능)

광고 이벤트가 여기에 표시됩니다.

📖 사용법

// 광고 설정
const player = new CatPlayer({
    container: '#player',
    url: 'video.mp4',
    ads: [
        {
            type: 'preroll',              // 재생 전 광고
            mediaType: 'video',           // 'video' 또는 'image'
            url: 'ad-video.mp4',
            skippable: true,              // 건너뛰기 가능
            skipAfter: 5,                 // 5초 후 건너뛰기 버튼
            clickUrl: 'https://ad.com'    // 클릭 시 URL
        },
        {
            type: 'midroll',              // 중간 광고
            mediaType: 'image',
            url: 'ad-image.jpg',
            time: 30,                     // 30초 시점에 재생
            duration: 7,                  // 이미지 표시 시간
            skippable: true,
            skipAfter: 3
        }
    ]
});

// 광고 이벤트
player.on('adStart', (ad) => {
    console.log('광고 시작:', ad.type);
});

player.on('adEnd', () => {
    console.log('광고 종료');
});

player.on('adSkipped', (ad) => {
    console.log('광고 건너뛰기:', ad.type);
});

player.on('adClick', (ad) => {
    console.log('광고 클릭:', ad.clickUrl);
});

✨ 광고 타입

  • Pre-roll - 영상 재생 전에 표시되는 광고
  • Mid-roll - 영상 중간에 표시되는 광고 (시간 지정)
  • Post-roll - 영상 종료 후 표시되는 광고 (준비 중)

🎨 미디어 타입

  • video - 비디오 광고 (mp4, webm 등)
  • image - 이미지 광고 (jpg, png 등) - duration 필수
💡 팁: 비디오를 처음 재생하면 Pre-roll 광고가 나타납니다. 15초와 30초 지점에 Mid-roll 광고가 자동으로 재생됩니다.