Thêm video

S3D Player có nút Catalog. Nút này mở Media Manager, một cửa sổ để truy cập nhanh vào video và hình ảnh 3D. Bạn chọn một nguồn từ danh sách, cuộn qua các thẻ và bắt đầu phát video chỉ với một cú nhấp. Nguồn có thể là một thư mục trên máy tính của bạn, một kênh YouTube hoặc máy chủ được bảo vệ bằng mật khẩu của riêng bạn. Các nguồn được mô tả trong một tệp cấu hình văn bản thuần, và bạn có thể thêm bao nhiêu tùy thích mà không cần lập trình.

trình quản lý phương tiện

Các phương thức kết nối

Trình phát hỗ trợ bốn loại nguồn video. Hãy chọn loại phù hợp với nhiệm vụ của bạn. Chúng có thể được kết hợp: một danh mục có thể chứa nhiều thư mục cục bộ, kênh và máy chủ.

Phương thức	Vị trí video	Những gì bạn cần	Lưu vào đĩa
Thư mục cục bộ	Trên máy tính của bạn	Chỉ đường dẫn thư mục	Không cần, các tệp đã thuộc về bạn
Kênh YouTube	Trên YouTube	Liên kết đến kênh	Được phép
Máy chủ của riêng bạn	Trên dịch vụ lưu trữ web của bạn	Dịch vụ lưu trữ có PHP, gói mã của chúng tôi	Nếu máy chủ cho phép
Máy chủ + Cloudflare R2	Trong lưu trữ đám mây Cloudflare R2	Dịch vụ lưu trữ có PHP, tài khoản Cloudflare, gói mã của chúng tôi	Nếu máy chủ cho phép

Cấu hình danh mục

Tất cả các nguồn phương tiện được mô tả trong hai tệp văn bản nằm trong thư mục trình phát plugins\catalog\. Bạn có thể mở chúng trực tiếp từ cửa sổ Media Manager bằng các nút Base và User. Sau khi tệp được lưu, cửa sổ sẽ tự động nhận các thay đổi.

catalog-base.txt: danh sách các nguồn minh họa cho trình phát. Tệp này thỉnh thoảng được thay thế bởi các bản cập nhật của trình phát, vì vậy đừng đặt các thay đổi của riêng bạn ở đây: chúng sẽ bị mất trong lần cập nhật tiếp theo.
catalog-user.txt: danh sách của riêng bạn. Các bản cập nhật không bao giờ sửa đổi nó.

Trong danh sách chọn nguồn, các nguồn xuất hiện theo cùng thứ tự như trong các tệp: đầu tiên là mọi thứ từ catalog-base.txt, sau đó là mọi thứ từ catalog-user.txt. Nếu tệp của bạn chứa một phần có cùng tên với một phần trong tệp cơ sở, cài đặt của bạn sẽ thay thế cài đặt cơ sở.

Định dạng tệp
Mỗi nguồn bắt đầu bằng một tên trong dấu ngoặc vuông, theo sau là các dòng có dạng key = value. Bất kỳ nội dung nào sau dấu # đều là chú thích. Cài đặt chung được ghi ở đầu tệp, trước phần đầu tiên:

# 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

Cách 1: thư mục trên máy tính của bạn

Cách đơn giản nhất. Trình phát quét thư mục và hiển thị tất cả video dưới dạng thẻ có bản xem trước. Bản xem trước được lấy từ một khung hình của chính video; đối với video 3D thì dùng khung hình bên trái.

Bước 1. Mở catalog-user.txt
Trong cửa sổ Media Manager, nhấp vào nút User.

Bước 2. Thêm một mục

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

path: đường dẫn đầy đủ đến thư mục chứa video.
recursive = 1: bao gồm cả các thư mục con. Nếu không có dòng này thì chỉ thư mục đó được quét.
include: chỉ hiển thị các video có tiêu đề chứa ít nhất một trong các từ này. Tùy chọn.
exclude: ẩn các video có tiêu đề chứa bất kỳ từ nào trong số này. Tùy chọn.

Bước 3. Lưu tệp
Chọn nguồn mới trong danh sách nguồn của cửa sổ. Thư mục được quét mỗi lần được chọn, nên các tệp mới sẽ xuất hiện trong danh sách ngay lập tức. Nếu thư mục không tồn tại, cửa sổ sẽ hiển thị Folder not found.

* Trình phát nhận diện định dạng 3D từ tên tệp, ví dụ movie_p.mp4 hoặc movie SBS.mkv. Nếu tên không chỉ định định dạng, bộ nhận diện định dạng của trình phát sẽ cố gắng xác định định dạng trong khi phát.

Cách 2: kênh YouTube

Trình phát hiển thị các video của kênh đã chọn dưới dạng danh mục và phát chúng mà không cần trình duyệt. Bộ lọc theo từ trong tiêu đề cho phép bạn chỉ giữ lại các video 3D và loại bỏ phần còn lại.

Bước 1. Thêm một mục vào 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: địa chỉ kênh.
include / exclude: các từ trong tiêu đề video để chọn video nào hiển thị và video nào ẩn.
search_max: số lượng video tối đa của kênh cần xem qua.
search_limit: số lượng video khớp cần đưa vào danh mục.

Bước 2. Nhấp vào Rescan
Để tránh kích hoạt cơ chế bảo vệ chống bot của YouTube, trình phát không bao giờ tự quét kênh. Khi cửa sổ mở ra, nó hiển thị danh sách đã lưu. Video mới chỉ được tải bằng nút Rescan và khi bạn cuộn đến cuối danh sách, mỗi lần đúng số lượng vừa với cửa sổ.

Bước 3. Nếu YouTube yêu cầu bạn xác nhận rằng bạn không phải là bot
Điều này xảy ra trên mạng lưới của trường đại học và văn phòng cũng như với một số nhà cung cấp internet lớn. Đăng nhập vào tài khoản YouTube của bạn trong trình duyệt Firefox. Sau đó trình phát sẽ sử dụng thông tin đăng nhập này để truy cập video một cách bình thường. Thêm dòng sau vào đầu tệp catalog-user.txt của bạn:

cookies = firefox

Thay vì firefox, bạn có thể cung cấp đường dẫn đến tệp cookies.txt. Các trình duyệt dựa trên Chrome (Chrome, Edge, Opera, Brave) sẽ không hoạt động: chúng mã hóa cookie của mình, nên trình phát không thể sử dụng chúng.

* Khi YouTube từ chối truy cập, trình phát sẽ tạm dừng các yêu cầu của mình trong 30 phút. Điều này bảo vệ địa chỉ IP của bạn khỏi bị chặn. Thời gian tạm dừng sẽ tự động được xóa sau một thời gian.

Phương pháp 3: danh mục riêng trên dịch vụ lưu trữ web của bạn

Dành cho những ai muốn hiển thị video 3D của riêng mình cho bạn bè, khách hàng hoặc khán giả của mình. Các video được lưu trữ trên dịch vụ lưu trữ web của bạn; trình phát nhận danh sách và phát chúng chỉ với tên đăng nhập và mật khẩu. Bạn quyết định ai có thể xem và ai được phép lưu video. Hãy thử bản demo, nó đã được bao gồm trong trình phát: S3D demo server

Những gì bạn cần
Một gói lưu trữ thông thường, không đắt tiền với PHP và Apache (hỗ trợ .htaccess). Không cần máy chủ chuyên dụng.

Gói mã: máy chủ video của riêng bạn

Bước 1. Tải gói lên dịch vụ lưu trữ của bạn
Giải nén tệp lưu trữ và sao chép thư mục vào dịch vụ lưu trữ của bạn, ví dụ vào /demo/. Video được đặt vào thư mục media của nó.

Bước 2. Cấu hình config.php
Mở config.php trong thư mục gói. Nó đặt tên tệp của bảng quản trị và mật khẩu ban đầu của nó. Hãy thay đổi cả hai trước khi trang web trở nên công khai.

Bước 3. Thêm người dùng
Trong bảng quản trị, hãy tạo người dùng với mật khẩu và đánh dấu những người được phép lưu video.

Bước 4. Kiểm tra máy chủ
Trong dấu nhắc lệnh Windows:

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

Phản hồi 200 với #private trên dòng đầu tiên: máy chủ hoạt động. Phản hồi 403: sai tên đăng nhập hoặc mật khẩu.

Bước 5. Thêm máy chủ vào trình phát

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

Chọn nguồn và nhấp vào Rescan. Lần tới khi cửa sổ mở ra, danh sách sẽ được lấy từ bộ nhớ đệm và làm mới trong nền.

Phương pháp 4: Cloudflare R2 + dịch vụ lưu trữ web của bạn

Cloudflare cung cấp các điều khoản rất thuận lợi để lưu trữ và phân phối tệp của bạn: lưu trữ miễn phí lên đến 10 GB và lưu lượng truy cập ra miễn phí, với mức giá phải chăng cho phần vượt quá. Hãy dùng một gói lưu trữ riêng nhỏ cho thông tin đăng nhập và mật khẩu, còn bản thân các video được lưu trong bộ nhớ đám mây Cloudflare R2 thay vì trên hosting. Hosting chỉ kiểm tra mật khẩu và cung cấp cho trình phát các liên kết. Video được truyền trực tiếp từ R2 đến người xem, nên các tệp lớn không chiếm dung lượng lẫn lưu lượng trên hosting của bạn. Hãy thử bản demo, nó đã được tích hợp sẵn trong trình phát: Cloudflare-R2 demo video

Cloudflare R2
Gói mã nguồn: R2 + video

Bước 1. Tạo một bucket R2
Trong bảng điều khiển Cloudflare, mở R2 object storage, tạo một bucket và tải video của bạn lên đó.

Bước 2. Tạo khóa truy cập
Trong R2 object storage, mục Account Details, nhấp vào Manage bên cạnh API Tokens. Quyền: Object Read only; bucket: chỉ của bạn (Apply to specific buckets only); TTL: Forever. Sau khi token được tạo, hãy sao chép Access Key ID và Secret Access Key. Khóa bí mật chỉ hiển thị một lần.

Bước 3. Tải gói lên hosting của bạn
Sao chép thư mục gói lên hosting của bạn, ví dụ vào /cloudflare/. Trong config.php, nhập Account ID, cả hai khóa và tên bucket, cùng với tên tệp bảng quản trị và mật khẩu của nó.

Bước 4. Thêm người dùng và kiểm tra
Giống như ở Phương pháp 3: người dùng trong bảng quản trị, kiểm tra bằng lệnh curl.

Bước 5. Thêm máy chủ vào trình phát

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

* Khóa R2 chỉ được lưu trên hosting; người xem không bao giờ nhận được nó. Máy chủ cấp các liên kết video tạm thời có hiệu lực trong 1 giờ.

Lưu video

Nếu nguồn cho phép lưu, tiêu đề cửa sổ hiển thị hộp kiểm Save. Khi được chọn, video cũng được ghi vào đĩa trong khi phát: vào thư mục save_dir của phần nguồn hoặc, nếu không được đặt ở đó, vào save_dir chung. Video từ các kênh YouTube luôn có thể được lưu. Máy chủ riêng chỉ cho phép lưu đối với những người dùng mà chủ máy chủ đã cho phép. Thư mục cục bộ không có tùy chọn lưu, vì các tệp đã có trên máy tính của bạn.

Quyền từ máy chủ riêng đến cùng với danh sách khi bạn nhấp vào Rescan. Cho đến khi nhấp vào Rescan, cửa sổ hiển thị No save thay vì hộp kiểm.

Khắc phục sự cố

Nếu danh sách trống, cửa sổ Media Manager sẽ hiển thị lý do.

No cache: press Rescan
Nguồn chưa bao giờ được tải. Nhấp vào Rescan.

Folder not found
Thư mục không tồn tại. Kiểm tra đường dẫn trong path.

Wrong user or password
Máy chủ đã từ chối đăng nhập hoặc mật khẩu. Kiểm tra user và password.

Too many attempts, wait 15 min
Quá nhiều lần đăng nhập thất bại liên tiếp. Hãy đợi 15 phút.

Server not responding
Không có kết nối mạng, hoặc địa chỉ trong url không đúng.

YouTube: requests refused
YouTube coi các yêu cầu là đáng ngờ. Bật cookies = firefox và đợi cho đến khi thời gian tạm dừng kết thúc.