README

CMS-Orbit을 위한 포괄적인 비디오 관리 시스템입니다.

주요 기능: 다중 프로파일 인코딩, HLS/DASH 스트리밍, 시청 기록, 강의 모드

🎯 최신 업데이트 (v1.1.5)

시청 기록 및 강의 모드

<!-- 일반 비디오 재생 -->
<Player :video-id="123" />

<!-- 강의 모드 (빨리감기 제한) -->
<Player :video-id="123" :lecture-mode="true" />

• ✅ 시청 기록 자동 저장 (사용자별/세션별)
• ✅ 마지막 시청 위치 자동 복원
• ✅ 강의 모드: 빨리감기 제한으로 순차적 시청 강제
• ✅ 비회원 → 로그인 시 시청 기록 자동 연결

📖 전체 변경사항 보기

✨ 주요 기능

🚀 빠른 시작

# 1. 설치
composer require cms-orbit/video-field

# 2. 설정 발행
php artisan vendor:publish --provider="CmsOrbit\VideoField\VideoServiceProvider" --tag="config"

# 3. 마이그레이션
php artisan migrate

# 4. 테마 스크립트 빌드
php artisan cms:build-theme-scripts

⚙️ 환경 설정

.env 파일 기본 설정:

# FFmpeg (필수)
FFMPEG_BINARY_PATH=ffmpeg
FFPROBE_BINARY_PATH=ffprobe

# 저장소
VIDEO_STORAGE_DISK=public
VIDEO_MAX_FILE_SIZE=5368709120  # 5GB

# 시청 기록 (선택)
VIDEO_COMPLETION_THRESHOLD=0.9  # 90% 시청 시 완료
VIDEO_WATCH_HISTORY_INTERVAL=5  # 5초마다 저장

📖 전체 설정 옵션 보기

📖 기본 사용법

1. 모델에 트레이트 추가

use CmsOrbit\VideoField\Traits\HasVideos;

class Post extends Model
{
    use HasVideos;
}

2. VideoField 사용 (Orchid)

use App\Settings\Extends\OrbitLayout;
use CmsOrbit\VideoField\Fields\VideoField\VideoField;

public function layout(): iterable
{
    return [
        OrbitLayout::rows([
            VideoField::make('post.main_video')
                ->title('Main Video')
        ])
    ];
}

3. 프론트엔드에서 비디오 재생

<script setup>
import Player from '@orbit/video/Player.vue';

defineProps({
    videoId: Number,
    lectureMode: {
        type: Boolean,
        default: false
    }
});
</script>

<template>
    <Player 
        :video-id="videoId" 
        :lecture-mode="lectureMode"
        show-title
        show-description
    />
</template>

📚 상세 문서

🎮 주요 Player Props

<Player
    :video-id="123"
    :lecture-mode="true"
    :autoplay="false"
    :muted="false"
    :show-title="true"
    :show-description="true"
    :show-quality-selector="true"
    :show-download="false"
    :use-native-controls="false"
    @play="handlePlay"
    @pause="handlePause"
    @ended="handleEnded"
/>

📖 전체 Props 및 이벤트 보기

🔧 관리자 패널

• 비디오 목록: /settings/orbit-video-fields/videos
• 비디오 업로드: /settings/orbit-video-fields/videos/create
• 비디오 편집: /settings/orbit-video-fields/videos/{id}/edit
• 휴지통: /settings/orbit-video-fields/videos/trash

🎯 시청 기록 API

// 시청 진행률 조회
const response = await axios.get(`/api/orbit-video-player/${videoId}/watch-history`);
console.log(response.data.data.percent); // 시청 진행률
console.log(response.data.data.is_complete); // 완료 여부

// 시청 진행률 저장 (자동으로 호출됨)
await axios.post(`/api/orbit-video-player/${videoId}/progress`, {
    current_time: 30.5,
    duration: 120.0
});

🤝 기여

이슈 및 PR은 언제든지 환영합니다!

📄 라이선스

MIT License - 자유롭게 사용하세요.

👨‍💻 저자

• xiso - ceo@amuz.co.kr

CMS-Orbit - 모던 Laravel CMS 시스템