PHPackages                             cms-orbit/video-field - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. cms-orbit/video-field

ActiveLibrary[File & Storage](/categories/file-storage)

cms-orbit/video-field
=====================

A comprehensive video upload and multi-encoding system for CMS-Orbit with streaming support, transcoding, and thumbnails

1.1.5(7mo ago)02MITPHPPHP ^8.2

Since Aug 4Pushed 7mo agoCompare

[ Source](https://github.com/cms-orbit/video-field)[ Packagist](https://packagist.org/packages/cms-orbit/video-field)[ RSS](/packages/cms-orbit-video-field/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (8)Used By (0)

CMS-Orbit Video Package
=======================

[](#cms-orbit-video-package)

[![Version](https://camo.githubusercontent.com/25f1115c795724a5871c55d30757d453987d3f15091d4898385c266e7b02c9a8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e312e352d626c75652e737667)](https://github.com/your-org/cms-orbit-video)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

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

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

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

[](#-최신-업데이트-v115)

### 시청 기록 및 강의 모드

[](#시청-기록-및-강의-모드)

```

```

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

📖 [전체 변경사항 보기](docs/PATCH_NOTE_1.1.5.md)

✨ 주요 기능
-------

[](#-주요-기능)

기능설명🎥 **비디오 관리**다중 업로드, 메타데이터 자동 추출, 진행률 모니터링🔄 **자동 인코딩**4K/FHD/HD/SD 다중 프로파일, HLS/DASH/Progressive MP4🖼️ **미디어 생성**썸네일, 스프라이트 시트 자동 생성📊 **시청 기록**사용자별/세션별 진행률 추적, 이어보기🎓 **강의 모드**빨리감기 제한으로 순차적 학습 강제🎛️ **관리자 UI**Orchid Platform 통합, 실시간 로그🔗 **VideoField**Orchid 커스텀 필드로 간편한 비디오 연결🚀 빠른 시작
-------

[](#-빠른-시작)

```
# 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초마다 저장
```

📖 [전체 설정 옵션 보기](config/orbit-video.php)

📖 기본 사용법
--------

[](#-기본-사용법)

### 1. 모델에 트레이트 추가

[](#1-모델에-트레이트-추가)

```
use CmsOrbit\VideoField\Traits\HasVideos;

class Post extends Model
{
    use HasVideos;
}
```

### 2. VideoField 사용 (Orchid)

[](#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. 프론트엔드에서 비디오 재생

[](#3-프론트엔드에서-비디오-재생)

```

import Player from '@orbit/video/Player.vue';

defineProps({
    videoId: Number,
    lectureMode: {
        type: Boolean,
        default: false
    }
});

```

📚 상세 문서
-------

[](#-상세-문서)

문서설명[플레이어 사용 가이드](docs/PLAYER_USAGE.md)Player 컴포넌트 props, 이벤트, 커스터마이징[플레이어 API](docs/PLAYER_API.md)API 엔드포인트 및 응답 형식[설정 가이드](config/orbit-video.php)전체 설정 옵션 및 설명[패치 노트 v1.1.5](docs/PATCH_NOTE_1.1.5.md)시청 기록 및 강의 모드 상세🎮 주요 Player Props
-----------------

[](#-주요-player-props)

```

```

📖 [전체 Props 및 이벤트 보기](docs/PLAYER_USAGE.md)

🔧 관리자 패널
--------

[](#-관리자-패널)

- **비디오 목록**: `/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
-----------

[](#-시청-기록-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** -

---

**CMS-Orbit** - 모던 Laravel CMS 시스템

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance63

Regular maintenance activity

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Total

7

Last Release

223d ago

PHP version history (2 changes)1.0.0PHP ^8.3

1.1.4PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/3d4228d7eaafb1a5b13e853f87189815feefd9c21f31363d08ec509c47f29d0a?d=identicon)[cms-orbit](/maintainers/cms-orbit)

---

Top Contributors

[![XisoDev](https://avatars.githubusercontent.com/u/10387955?v=4)](https://github.com/XisoDev "XisoDev (16 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cms-orbit-video-field/health.svg)

```
[![Health](https://phpackages.com/badges/cms-orbit-video-field/health.svg)](https://phpackages.com/packages/cms-orbit-video-field)
```

###  Alternatives

[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)