비디오 추가하기

S3D Player에는 Catalog 버튼이 있습니다. 이 버튼을 누르면 3D 비디오와 사진에 빠르게 접근할 수 있는 창인 Media Manager가 열립니다. 목록에서 소스를 선택하고, 카드를 스크롤하며, 클릭 한 번으로 비디오를 시작할 수 있습니다. 소스는 컴퓨터의 폴더, YouTube 채널 또는 비밀번호로 보호되는 자체 서버일 수 있습니다. 소스는 일반 텍스트 구성 파일에 설명되어 있으며, 프로그래밍 없이 필요한 만큼 추가할 수 있습니다.

미디어 관리자

연결 방법

플레이어는 네 가지 유형의 비디오 소스를 지원합니다. 작업에 맞는 것을 선택하세요. 이들은 결합될 수 있습니다: 하나의 카탈로그에 여러 로컬 폴더, 채널 및 서버가 포함될 수 있습니다.

방법	비디오가 있는 위치	필요한 것	디스크에 저장
로컬 폴더	컴퓨터에 있음	폴더 경로만 있으면 됨	필요 없음, 파일은 이미 소유하고 있음
YouTube 채널	YouTube에 있음	채널 링크	허용됨
자체 서버	웹 호스팅에 있음	PHP가 있는 호스팅, 코드 패키지	서버가 허용하는 경우
서버 + Cloudflare R2	Cloudflare R2 클라우드 스토리지에 있음	PHP가 있는 호스팅, Cloudflare 계정, 코드 패키지	서버가 허용하는 경우

카탈로그 구성

모든 미디어 소스는 플레이어 폴더 plugins\catalog\에 있는 두 개의 텍스트 파일에 설명되어 있습니다. Media Manager 창에서 Base 및 User 버튼으로 직접 열 수 있습니다. 파일이 저장되면 창이 변경 사항을 자동으로 반영합니다.

catalog-base.txt: 플레이어를 시연하는 소스 목록입니다. 이 파일은 때때로 플레이어 업데이트로 교체되므로, 여기에 자신의 변경 사항을 넣지 마세요: 다음 업데이트에서 손실됩니다.
catalog-user.txt: 자신의 목록입니다. 업데이트는 이를 절대 수정하지 않습니다.

소스 선택 목록에서 소스는 파일에 있는 순서대로 나타납니다: 먼저 catalog-base.txt의 모든 항목, 그 다음 catalog-user.txt의 모든 항목입니다. 파일에 기본 파일과 동일한 이름의 섹션이 포함되어 있으면, 설정이 기본 설정을 대체합니다.

파일 형식
각 소스는 대괄호 안의 이름으로 시작하고, 그 뒤에 key = value 형식의 줄이 이어집니다. # 기호 뒤의 모든 내용은 주석입니다. 일반 설정은 첫 번째 섹션 앞, 파일 상단에 작성됩니다:

# general settings
quality  = 1080      # 720 / 1080 / 2160
thumb    = max       # preview: mq / 720 / max
save_dir = D:\Video\Saved
cookies  = firefox   # YouTube sign in, see the YouTube section

# source
[My 3D videos]
path      = D:\Video\3D
recursive = 1

방법 1: 컴퓨터의 폴더

가장 간단한 방법입니다. 플레이어가 폴더를 검색하여 모든 동영상을 미리보기가 있는 카드로 표시합니다. 미리보기는 동영상 자체의 프레임에서 가져오며, 3D 동영상의 경우 왼쪽 뷰가 사용됩니다.

1단계. catalog-user.txt 열기
Media Manager 창에서 User 버튼을 클릭합니다.

2단계. 섹션 추가

[My 3D videos]
path      = D:\Video\3D
recursive = 1
include   = SBS, 3D

path: 동영상이 있는 폴더의 전체 경로입니다.
recursive = 1: 하위 폴더도 포함합니다. 이 줄이 없으면 폴더 자체만 검색됩니다.
include: 제목에 이 단어 중 하나 이상이 포함된 동영상만 표시합니다. 선택 사항입니다.
exclude: 제목에 이 단어 중 하나라도 포함된 동영상을 숨깁니다. 선택 사항입니다.

3단계. 파일 저장
창의 소스 목록에서 새 소스를 선택합니다. 폴더는 선택할 때마다 검색되므로 새 파일이 목록에 바로 나타납니다. 폴더가 존재하지 않으면 창에 Folder not found가 표시됩니다.

* 플레이어는 파일 이름에서 3D 형식을 감지합니다. 예: movie_p.mp4 또는 movie SBS.mkv. 이름에 형식이 지정되지 않은 경우 플레이어의 형식 감지기가 재생 중에 이를 판별하려고 시도합니다.

방법 2: YouTube 채널

플레이어는 선택한 채널의 동영상을 카탈로그로 표시하고 브라우저 없이 재생합니다. 제목의 단어로 필터링하여 3D 동영상만 유지하고 나머지는 제외할 수 있습니다.

1단계. catalog-user.txt에 섹션 추가

[4K Cine Trailer]
url          = https://www.youtube.com/@4kcinematrailer
include      = 3D, SBS
exclude      = anaglyph, VR
search_max   = 3000
search_limit = 200

url: 채널 주소입니다.
include / exclude: 표시할 동영상과 숨길 동영상을 선택하는 동영상 제목의 단어입니다.
search_max: 살펴볼 채널 동영상의 최대 개수입니다.
search_limit: 카탈로그에 넣을 일치하는 동영상의 개수입니다.

2단계. Rescan 클릭
YouTube 봇 보호가 작동하지 않도록 플레이어는 채널을 자체적으로 검색하지 않습니다. 창이 열리면 저장된 목록을 표시합니다. 새 동영상은 Rescan 버튼을 통해서만, 그리고 목록 끝까지 스크롤할 때마다 창에 맞는 만큼만 로드됩니다.

3단계. YouTube에서 봇이 아님을 확인하라는 메시지가 표시되는 경우
이 문제는 대학 및 사무실 네트워크와 일부 대형 인터넷 제공업체에서 발생합니다. Firefox 브라우저에서 YouTube 계정에 로그인하세요. 그러면 플레이어가 이 로그인을 사용하여 정상적으로 동영상에 접근합니다. catalog-user.txt 맨 위에 다음 줄을 추가하세요:

cookies = firefox

firefox 대신 cookies.txt 파일의 경로를 지정할 수 있습니다. Chrome 기반 브라우저 (Chrome, Edge, Opera, Brave)는 작동하지 않습니다. 쿠키를 암호화하기 때문에 플레이어가 사용할 수 없습니다.

* YouTube가 접근을 거부하면 플레이어는 30분 동안 요청을 일시 중지합니다. 이는 IP 주소가 차단되는 것을 방지합니다. 일시 중지는 잠시 후 자동으로 해제됩니다.

방법 3: 웹 호스팅의 비공개 카탈로그

자신의 3D 동영상을 친구, 고객 또는 시청자에게 보여주고 싶은 분들을 위한 방법입니다. 동영상은 웹 호스팅에 저장되며, 플레이어는 로그인과 비밀번호를 통해서만 목록을 받아 재생합니다. 누가 시청할 수 있고 누가 동영상을 저장할 수 있는지 직접 결정합니다. 데모를 사용해 보세요. 플레이어에 이미 포함되어 있습니다: S3D demo server

필요한 것
PHP와 Apache (.htaccess 지원)가 있는 일반적인 저렴한 호스팅 요금제. 전용 서버는 필요하지 않습니다.

코드 패키지: 나만의 동영상 서버

1단계. 패키지를 호스팅에 업로드
압축을 풀고 폴더를 호스팅에 복사하세요. 예를 들어 /demo/에 복사합니다. 동영상은 해당 폴더의 media 폴더에 넣습니다.

2단계. config.php 구성
패키지 폴더에서 config.php를 여세요. 이 파일은 관리자 패널의 파일 이름과 초기 비밀번호를 설정합니다. 사이트가 공개되기 전에 둘 다 변경하세요.

3단계. 사용자 추가
관리자 패널에서 비밀번호가 있는 사용자를 만들고 그중 동영상 저장이 허용된 사용자를 표시하세요.

4단계. 서버 테스트
Windows 명령 프롬프트에서:

curl -i -X POST -d "user=demo-user&pass=12345" "https://example.com/demo/list.php"

첫 줄에 #private와 함께 200 응답이 오면 서버가 작동하는 것입니다. 403 응답은 로그인 또는 비밀번호가 잘못된 것입니다.

5단계. 플레이어에 서버 추가

[My server]
url      = https://example.com/demo/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved

소스를 선택하고 Rescan을 클릭하세요. 다음에 창을 열면 목록은 캐시에서 가져오고 백그라운드에서 새로 고칩니다.

방법 4: Cloudflare R2 + 웹 호스팅

Cloudflare는 파일 저장 및 제공에 매우 유리한 조건을 제공합니다: 최대 10GB의 저장 공간을 무료로 제공하고 아웃바운드 트래픽도 무료이며, 그 이상은 합리적인 가격입니다. 로그인과 비밀번호에는 소규모 개인 호스팅 요금제를 사용하고, 동영상 자체는 호스팅이 아닌 Cloudflare R2 클라우드 스토리지에 저장됩니다. 호스팅은 비밀번호만 확인하고 플레이어에게 링크를 제공합니다. 동영상은 R2에서 시청자에게 직접 전송되므로, 큰 파일이 호스팅의 공간이나 트래픽을 차지하지 않습니다. 데모를 사용해 보세요. 플레이어에 이미 포함되어 있습니다: Cloudflare-R2 demo video

Cloudflare R2
코드 패키지: R2 + video

1단계. R2 버킷 생성
Cloudflare 대시보드에서 R2 object storage를 열고, 버킷을 생성한 후 동영상을 업로드하세요.

2단계. 액세스 키 생성
R2 object storage의 Account Details에서 API Tokens 옆의 Manage를 클릭하세요. 권한: Object Read only; 버킷: 본인 것만 (Apply to specific buckets only); TTL: Forever. 토큰이 생성되면 Access Key ID와 Secret Access Key를 복사하세요. 시크릿은 한 번만 표시됩니다.

3단계. 호스팅에 패키지 업로드
패키지 폴더를 호스팅에 복사하세요. 예를 들어 /cloudflare/에 복사합니다. config.php에 Account ID, 두 키, 버킷 이름, 그리고 관리자 패널 파일 이름과 비밀번호를 입력하세요.

4단계. 사용자 추가 및 테스트
방법 3과 동일합니다: 관리자 패널에서 사용자를 추가하고, curl 명령으로 테스트합니다.

5단계. 플레이어에 서버 추가

[My R2 server]
url      = https://example.com/cloudflare/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved

* R2 키는 호스팅에만 저장되며, 시청자는 절대 접근할 수 없습니다. 서버는 1시간 동안 유효한 임시 동영상 링크를 발급합니다.

동영상 저장

소스가 저장을 허용하는 경우, 창 헤더에 Save 체크박스가 표시됩니다. 체크하면 동영상이 재생되는 동안 디스크에도 기록됩니다: 소스 섹션의 save_dir 폴더에 저장되며, 해당 폴더가 설정되지 않은 경우 일반 save_dir에 저장됩니다. YouTube 채널의 동영상은 항상 저장할 수 있습니다. 개인 서버는 서버 소유자가 허용한 사용자만 저장할 수 있습니다. 로컬 폴더는 파일이 이미 컴퓨터에 있으므로 저장 옵션이 없습니다.

개인 서버의 권한은 Rescan을 클릭할 때 목록과 함께 전달됩니다. Rescan을 클릭하기 전까지 창에는 체크박스 대신 No save가 표시됩니다.

문제 해결

목록이 비어 있으면 Media Manager 창에 그 이유가 표시됩니다.

캐시 없음: 다시 검색을 누르세요
소스가 한 번도 로드되지 않았습니다. 다시 검색을 클릭하세요.

폴더를 찾을 수 없음
폴더가 존재하지 않습니다. path의 경로를 확인하세요.

사용자 또는 비밀번호가 잘못됨
서버가 로그인 또는 비밀번호를 거부했습니다. user와 password를 확인하세요.

시도 횟수가 너무 많음, 15분 대기
연속으로 로그인 시도가 너무 많이 실패했습니다. 15분 동안 기다리세요.

서버가 응답하지 않음
네트워크 연결이 없거나 url의 주소가 잘못되었습니다.

YouTube: 요청이 거부됨
YouTube가 요청을 의심스러운 것으로 판단했습니다. cookies = firefox를 활성화하고 일시 중지가 끝날 때까지 기다리세요.