Adicionar vídeo

S3D Player tem um botão Catalog. Ele abre o Media Manager, uma janela para acesso rápido a vídeos e imagens 3D. Você seleciona uma fonte na lista, percorre os cartões e inicia um vídeo com um único clique. Uma fonte pode ser uma pasta no seu computador, um canal do YouTube ou seu próprio servidor protegido por senha. As fontes são descritas em um arquivo de configuração de texto simples, e você pode adicionar quantas precisar sem nenhuma programação.

gerenciador de mídia

Métodos de conexão

O player suporta quatro tipos de fontes de vídeo. Escolha o que se adequa à sua tarefa. Eles podem ser combinados: um catálogo pode conter várias pastas locais, canais e servidores.

Método	Onde estão os vídeos	O que você precisa	Salvar no disco
Pasta local	No seu computador	Apenas o caminho da pasta	Não é necessário, os arquivos já são seus
Canal do YouTube	No YouTube	Um link para o canal	Permitido
Seu próprio servidor	Na sua hospedagem web	Hospedagem com PHP, nosso pacote de código	Se o servidor permitir
Servidor + Cloudflare R2	No armazenamento em nuvem Cloudflare R2	Hospedagem com PHP, uma conta Cloudflare, nosso pacote de código	Se o servidor permitir

Configuração do catálogo

Todas as fontes de mídia são descritas em dois arquivos de texto localizados na pasta do player plugins\catalog\. Você pode abri-los diretamente da janela Media Manager com os botões Base e User. Depois que um arquivo é salvo, a janela capta as alterações automaticamente.

catalog-base.txt: uma lista de fontes que demonstra o player. Este arquivo é substituído pelas atualizações do player de tempos em tempos, então não coloque suas próprias alterações aqui: elas serão perdidas na próxima atualização.
catalog-user.txt: sua própria lista. As atualizações nunca a modificam.

Na lista de seleção de fontes, as fontes aparecem na mesma ordem dos arquivos: primeiro tudo de catalog-base.txt, depois tudo de catalog-user.txt. Se o seu arquivo contiver uma seção com o mesmo nome de uma no arquivo base, suas configurações substituem as da base.

Formato do arquivo
Cada fonte começa com um nome entre colchetes, seguido por linhas no formato chave = valor. Qualquer coisa após o sinal # é um comentário. As configurações gerais são escritas no topo do arquivo, antes da primeira seção:

# 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

Método 1: uma pasta no seu computador

O método mais simples. O player varre a pasta e mostra todos os vídeos como cartões com pré-visualizações. As pré-visualizações são obtidas de um quadro do próprio vídeo; para vídeos 3D é usada a vista esquerda.

Passo 1. Abra catalog-user.txt
Na janela do Media Manager, clique no botão User.

Passo 2. Adicione uma seção

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

path: o caminho completo para a pasta com os vídeos.
recursive = 1: inclui também as subpastas. Sem esta linha, apenas a própria pasta é varrida.
include: mostra apenas os vídeos cujo título contém pelo menos uma destas palavras. Opcional.
exclude: oculta os vídeos cujo título contém qualquer uma destas palavras. Opcional.

Passo 3. Salve o arquivo
Selecione a nova fonte na lista de fontes da janela. A pasta é varrida sempre que é selecionada, por isso os novos arquivos aparecem na lista imediatamente. Se a pasta não existir, a janela mostra Folder not found.

* O player detecta o formato 3D a partir do nome do arquivo, por exemplo movie_p.mp4 ou movie SBS.mkv. Se o nome não especificar o formato, o detector de formato do player tenta determiná-lo durante a reprodução.

Método 2: um canal do YouTube

O player mostra os vídeos do canal selecionado como um catálogo e os reproduz sem navegador. Um filtro por palavras no título permite manter apenas os vídeos 3D e descartar o resto.

Passo 1. Adicione uma seção ao 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: o endereço do canal.
include / exclude: palavras nos títulos dos vídeos que selecionam quais vídeos mostrar e quais ocultar.
search_max: o número máximo de vídeos do canal a examinar.
search_limit: quantos vídeos correspondentes colocar no catálogo.

Passo 2. Clique em Rescan
Para evitar acionar a proteção anti-bot do YouTube, o player nunca varre canais por conta própria. Quando a janela abre, ela mostra a lista salva. Novos vídeos são carregados apenas pelo botão Rescan e quando você rola até o fim da lista, cada vez exatamente tantos quantos cabem na janela.

Passo 3. Se o YouTube pedir que você confirme que não é um bot
Isso acontece em redes universitárias e de escritórios e com alguns grandes provedores de internet. Faça login na sua conta do YouTube no navegador Firefox. O player usará esse login para acessar os vídeos normalmente. Adicione a seguinte linha no topo do seu catalog-user.txt:

cookies = firefox

Em vez de firefox, você pode informar o caminho para um arquivo cookies.txt. Navegadores baseados no Chrome (Chrome, Edge, Opera, Brave) não funcionarão: eles criptografam seus cookies, então o player não pode usá-los.

* Quando o YouTube recusa o acesso, o player pausa suas solicitações por 30 minutos. Isso protege seu endereço IP de ser bloqueado. A pausa é encerrada automaticamente após um tempo.

Método 3: um catálogo privado na sua hospedagem web

Para quem deseja mostrar seus próprios vídeos 3D a amigos, clientes ou ao seu público. Os vídeos ficam armazenados na sua hospedagem web; o player obtém a lista e os reproduz somente com login e senha. Você decide quem pode assistir e quem tem permissão para salvar os vídeos. Experimente a demonstração, ela já está incluída no player: S3D demo server

O que você precisa
Um plano de hospedagem comum e barato com PHP e Apache (suporte a .htaccess). Não é necessário um servidor dedicado.

Pacote de código: seu próprio servidor de vídeo

Etapa 1. Envie o pacote para sua hospedagem
Descompacte o arquivo e copie a pasta para sua hospedagem, por exemplo para /demo/. Os vídeos vão para a pasta media dela.

Etapa 2. Configure o config.php
Abra o config.php na pasta do pacote. Ele define o nome do arquivo do painel de administração e sua senha inicial. Altere ambos antes que o site fique acessível publicamente.

Etapa 3. Adicione usuários
No painel de administração, crie usuários com senhas e marque quais deles têm permissão para salvar vídeos.

Etapa 4. Teste o servidor
No prompt de comando do Windows:

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

Resposta 200 com #private na primeira linha: o servidor funciona. Resposta 403: login ou senha incorretos.

Etapa 5. Adicione o servidor ao player

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

Selecione a fonte e clique em Rescan. Na próxima vez que a janela abrir, a lista será obtida do cache e atualizada em segundo plano.

Método 4: Cloudflare R2 + sua hospedagem web

Cloudflare oferece condições muito favoráveis para armazenar e servir seus arquivos: até 10 GB de armazenamento gratuitamente e tráfego de saída gratuito, com preços moderados além disso. Use um pequeno plano de hospedagem privada para logins e senhas, enquanto os vídeos em si ficam armazenados no armazenamento em nuvem Cloudflare R2 em vez de na hospedagem. A hospedagem apenas verifica a senha e fornece ao player os links. O vídeo vai para o espectador diretamente do R2, então arquivos grandes não ocupam espaço nem tráfego na sua hospedagem. Experimente a demonstração, ela já está incluída no player: Cloudflare-R2 demo video

Cloudflare R2
Pacote de código: R2 + video

Passo 1. Crie um bucket R2
No painel do Cloudflare, abra R2 object storage, crie um bucket e envie seus vídeos para ele.

Passo 2. Crie uma chave de acesso
Em R2 object storage, em Account Details, clique em Manage ao lado de API Tokens. Permissões: Object Read only; bucket: apenas o seu (Apply to specific buckets only); TTL: Forever. Depois que o token for criado, copie o Access Key ID e a Secret Access Key. O segredo é mostrado apenas uma vez.

Passo 3. Envie o pacote para sua hospedagem
Copie a pasta do pacote para sua hospedagem, por exemplo para /cloudflare/. Em config.php, insira o Account ID, ambas as chaves e o nome do bucket, bem como o nome do arquivo do painel de administração e sua senha.

Passo 4. Adicione usuários e teste
O mesmo que no Método 3: usuários no painel de administração, um teste com o comando curl.

Passo 5. Adicione o servidor ao player

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

* A chave do R2 é armazenada apenas na hospedagem; os espectadores nunca a recebem. O servidor emite links de vídeo temporários válidos por 1 hora.

Salvando vídeos

Se a fonte permitir salvar, o cabeçalho da janela mostra uma caixa de seleção Save. Quando ela está marcada, um vídeo também é gravado no disco enquanto é reproduzido: na pasta save_dir da seção da fonte ou, se nenhuma estiver definida lá, no save_dir geral. Vídeos de canais do YouTube sempre podem ser salvos. Um servidor privado permite salvar apenas para os usuários que o proprietário do servidor autorizou. Uma pasta local não tem opção de salvar, já que os arquivos já estão no seu computador.

A permissão de um servidor privado chega junto com a lista quando você clica em Rescan. Até que Rescan seja clicado, a janela mostra No save em vez da caixa de seleção.

Solução de problemas

Se a lista estiver vazia, a janela Media Manager mostra o motivo.

No cache: press Rescan
A fonte nunca foi carregada. Clique em Rescan.

Folder not found
A pasta não existe. Verifique o caminho em path.

Wrong user or password
O servidor rejeitou o login ou a senha. Verifique user e password.

Too many attempts, wait 15 min
Muitas tentativas de login falhadas seguidas. Aguarde 15 minutos.

Server not responding
Sem conexão de rede, ou o endereço em url está errado.

YouTube: requests refused
O YouTube considerou as solicitações suspeitas. Ative cookies = firefox e aguarde até que a pausa termine.