Problemas de Importação/Exportação

O WayPresenter suporta a importação e exportação de músicas, mídias, temas e outros conteúdos. Quando uma importação ou exportação não sai como esperado, este guia ajudará a resolver o problema.

Erros Comuns de Importação

"Formato de Arquivo Não Compatível"

Este erro aparece quando o arquivo selecionado não está em um formato que o WayPresenter reconhece. Verifique a extensão do arquivo e certifique-se de que corresponde a um dos formatos suportados listados abaixo. Se o arquivo foi renomeado manualmente, a extensão pode não corresponder ao conteúdo real.

"Não Foi Possível Ler o Arquivo"

O arquivo pode estar corrompido, bloqueado por outro aplicativo ou armazenado em uma unidade de rede que não está acessível no momento. Tente copiar o arquivo para o seu disco rígido local e importá-lo de lá. Se o arquivo foi baixado da internet, tente baixá-lo novamente.

"Importação Concluída com Avisos"

Isso significa que a importação foi parcialmente bem-sucedida, mas parte do conteúdo não pôde ser processada. Clique em Ver Avisos na caixa de diálogo de resumo de importação para ver quais itens falharam e por quê. Os motivos comuns incluem campos de metadados ausentes, caracteres não compatíveis em títulos de músicas ou mídias incorporadas que não puderam ser resolvidas.

"Conteúdo Duplicado Detectado"

O WayPresenter verifica duplicatas durante a importação com base no título e autor da música. Se uma correspondência for encontrada, você é perguntado se quer ignorar, substituir ou manter ambos. Escolha a opção que melhor se adapta à sua situação:

• Ignorar: Mantém a versão existente e ignora a importada.
• Substituir: Substitui a versão existente pela importada.
• Manter Ambas: Importa a nova versão junto com a existente, adicionando "(importado)" ao título.

Formatos Compatíveis

Formatos de Importação de Músicas

Formatos de Importação de Mídias

Imagens (JPEG, PNG, WebP, BMP, GIF), vídeos (MP4, WebM, MOV, AVI) e áudio (MP3, WAV, OGG) são todos compatíveis. Consulte a documentação da Biblioteca de Mídias para informações detalhadas sobre formatos.

Formato de Importação de Temas

Os temas usam o formato proprietário .wptheme do WayPresenter, que agrupa todas as configurações, fontes e mídias incorporadas em um único arquivo.

Problemas de Codificação de Arquivos

Os arquivos de importação baseados em texto (texto simples e XML) devem usar uma codificação de caracteres compatível. O WayPresenter lê arquivos em UTF-8 por padrão.

Sintomas de Problemas de Codificação

• Caracteres especiais (letras acentuadas, aspas tipográficas, travessões) aparecem como símbolos ilegíveis ou pontos de interrogação.
• Títulos ou letras de músicas contêm caracteres inesperados como é em vez de e com acento.
• A importação falha completamente com um erro de análise.

Como Resolver Problemas de Codificação

1. Abra o arquivo em um editor de texto que exiba a codificação atual (como Notepad++, VS Code ou Sublime Text).
2. Verifique a codificação exibida na barra de status. Se mostrar algo diferente de UTF-8 (ex.: Windows-1252, ISO-8859-1 ou ANSI), converta-o.
3. Na maioria dos editores, use Arquivo > Salvar Como ou Arquivo > Definir Codificação e selecione UTF-8.
4. Salve o arquivo e tente a importação novamente no WayPresenter.

Se você está importando um lote de arquivos com codificações mistas, o utilitário Ferramentas > Converter Codificação em Lote do WayPresenter pode converter uma pasta inteira para UTF-8 antes da importação.

Compatibilidade de Banco de Dados

Ao migrar conteúdo de outro aplicativo de apresentação ou de uma versão anterior do WayPresenter, a compatibilidade do banco de dados pode ser uma preocupação.

Migrar de Outro Aplicativo

O WayPresenter suporta importação direta de arquivos de projeto ProPresenter 6 e 7. Para outros aplicativos, exporte seu conteúdo em um dos formatos de intercâmbio compatíveis (OpenLyrics XML é o mais amplamente compatível) e importe esse arquivo no WayPresenter.

Migrar de uma Versão Anterior do WayPresenter

O WayPresenter atualiza automaticamente seu banco de dados interno quando você instala uma nova versão. Se você está importando um arquivo de backup criado por uma versão significativamente mais antiga, o WayPresenter tentará atualizar os dados durante a importação. Se a diferença de versão for muito grande, você poderá ver um aviso de compatibilidade. Nesse caso:

1. Instale a versão intermediária do WayPresenter mencionada no aviso.
2. Importe o backup nessa versão.
3. Exporte um novo backup dessa versão.
4. Importe o novo backup na versão atual.

Importações Parciais

Se apenas alguns itens de uma importação em lote forem bem-sucedidos, a caixa de diálogo de resumo de importação fornece detalhes sobre o que foi ignorado e por quê.

Causas Comuns de Importações Parciais

• Campos obrigatórios ausentes: Músicas sem título não podem ser importadas. Adicione um título ao arquivo fonte e tente novamente.
• Arquivos individuais corrompidos: Em uma importação de pasta, um arquivo defeituoso não para o restante. Verifique os arquivos ignorados individualmente.
• Limites de tamanho de arquivo: Arquivos de mídia individuais com mais de 500 MB são ignorados por padrão. Comprima ou otimize o arquivo e tente novamente, ou aumente o limite em Configurações > Avançado > Importar.

Opções e Formatos de Exportação

Exportar Músicas

1. Selecione uma ou mais músicas na Biblioteca de Músicas.
2. Clique em Exportar na barra de ferramentas.
3. Escolha o formato:
   • OpenLyrics XML: Melhor para interoperabilidade com outros aplicativos.
   • Texto simples: Formato simples adequado para impressão ou arquivamento.
   • Formato WayPresenter (.wpsong): Preserva todos os metadados, arranjos e configurações de exibição. Melhor para backup ou transferência para outra instalação do WayPresenter.
4. Selecione uma pasta de destino e clique em Salvar.

Exportar Temas e Mídias

• Temas: Clique com o botão direito em um tema em Configurações > Temas e selecione Exportar. O arquivo .wptheme inclui todos os recursos associados.
• Mídias: Selecione itens na Biblioteca de Mídias, clique em Exportar e escolha um destino. Os arquivos são copiados em seu formato original.

Backup e Restauração

O recurso de backup do WayPresenter captura toda a sua biblioteca — músicas, versículos, marcadores, temas, configurações e referências de mídias — em um único arquivo.

Criar um Backup

1. Vá em Arquivo > Backup > Criar Backup.
2. Escolha se quer incluir arquivos de mídia (isso aumenta significativamente o tamanho do backup).
3. Selecione uma pasta de destino.
4. Clique em Criar. O backup é salvo como um arquivo .wpbackup.

Restaurar a partir de um Backup

1. Vá em Arquivo > Backup > Restaurar Backup.
2. Selecione o arquivo .wpbackup.
3. Escolha se quer substituir sua biblioteca atual por completo ou mesclar o backup com seu conteúdo existente.
4. Clique em Restaurar. O WayPresenter reiniciará após a restauração ser concluída.

É uma boa prática criar um backup antes de cada atualização importante e manter backups em uma unidade externa ou em armazenamento na nuvem.