Sumário (TOC) personalizado do audiolivro

Visão geral

Ao fazer upload de um audiolivro no Google Play Livros, você pode especificar um sumário (TOC, na sigla em inglês) personalizado, conforme descrito na especificação de audiolivros do W3C (link em inglês).

Com este exemplo simplificado, você pode aprender a fazer upload de arquivos de áudio e um TOC personalizado. Casos de uso detalhados são abordados na especificação.

De modo geral, para fazer upload de arquivos de áudio e um TOC personalizado:

1. Crie um arquivo HTML com o nome toc.html que especifique o TOC.
   • Exemplo (link em inglês)
2. Crie um arquivo de manifesto chamado publication.json que liste seus arquivos de áudio e direcione ao TOC.
   • Exemplo (link em inglês)
3. Adicione toc.html e publication.json a uma pasta com seus arquivos de áudio.
4. Compacte a pasta.
5. Mude a extensão do arquivo de .zip para .lpf.
6. Faça upload do arquivo .lpf para a Central de parceiros do Google Livros.

Exemplo simples

Importante: as seções abaixo dão mais detalhes com o uso de um audiolivro simples como exemplo.

Para fazer upload do TOC personalizado de um audiolivro chamado "Meu Audiolivro Legal" com um ISBN "123", que inclui 5 arquivos .mp3:

• 123_1of5.mp3
  • Prólogo
• 123_2of5.mp3
  • Capítulo 1: Início
• 123_3of5.mp3
  • Capítulo 2: Meio
• 123_4of5.mp3
  • Capítulo 3: Fim
• 123_5of5.mp3
  • Epílogo

Etapa 1: criar um diretório

Para começar, crie um diretório ou pasta com o nome 123, já que 123 é o ISBN do nosso audiolivro.

Etapa 2: colocar arquivos de áudio no diretório

Adicione os arquivos de áudio ao diretório criado. A estrutura de diretórios é assim:

123/

├── 123_1of5.mp3

├── 123_2of5.mp3

├── 123_3of5.mp3

├── 123_4of5.mp3

└── 123_5of5.mp3

Etapa 3: criar um arquivo de TOC

Crie um arquivo chamado toc.html para armazenar o sumário (link em inglês):

123/

├── 123_1of5.mp3

├── 123_2of5.mp3

├── 123_3of5.mp3

├── 123_4of5.mp3

├── 123_5of5.mp3

└── toc.html

Etapa 4: preencher o arquivo de TOC

Com uma lista dos arquivos e dos nomes que devem ser mostrados para eles no TOC, preencha toc.html:

<nav role="doc-toc">

 <h2>Meu Audiolivro Legal</h2>

 <ol>

  <li><a href="123_1of5.mp3">Prólogo</a></li>

  <li><a href="123_2of5.mp3">Capítulo 1: Início</a></li>

  <li><a href="123_3of5.mp3">Capítulo 2: Meio</a></li>

  <li><a href="123_4of5.mp3">Capítulo 3: Fim</a></li>

  <li><a href="123_5of5.mp3">Epílogo</a></li>

 </ol>

</nav>

Dicas:

• O título do livro fica entre as tags <h2>.
• Há um <li> para cada arquivo de áudio.
  • Por exemplo, se você quiser dividir um arquivo de áudio em várias partes, é possível especificar várias entradas de sumário (link em inglês).
• O atributo href é o local relativo do arquivo de áudio.
  • No seu caso, esse é apenas o nome do arquivo de áudio, já que toc.html e os arquivos de áudio estão no mesmo diretório.
  • Se você colocar os arquivos de áudio em um subdiretório com o nome audio, o valor do atributo href do prólogo será audio/123_1of5.mp3.

Etapa 5: criar um manifesto

Crie um arquivo chamado publication.json para armazenar o manifesto do audiolivro:

123/

├── 123_1of5.mp3

├── 123_2of5.mp3

├── 123_3of5.mp3

├── 123_4of5.mp3

├── 123_5of5.mp3

├── publication.json

└── toc.html

Etapa 6: preencher o manifesto

Preencha o arquivo publication.json com detalhes sobre o audiolivro:

{

  "@context": [

  "https://schema.org",

  "https://www.w3.org/ns/pub-context"

 ],

  "conformsTo" : "https://www.w3.org/TR/audiobooks/",

  "name": "Meu Audiolivro Legal",

  "resources": [

  {

   "name": "Sumário",

   "rel": "contents",

   "url": "toc.html"

  }

 ],

  "readingOrder": [

  "123_1of5.mp3",

  "123_2of5.mp3",

  "123_3of5.mp3",

  "123_4of5.mp3",

  "123_5of5.mp3"

 ]

}

Dicas:

• O valor de name é o título do audiolivro.
• A matriz resources contém uma referência a toc.html.
  • Ao adaptar este exemplo ao seu audiolivro, não mude o elemento da matriz resources, a menos que você dê um nome diferente ao arquivo de TOC, que não seja toc.html.
• A matriz readingOrder contém uma lista de URLs relativos para arquivos de áudio, listados na ordem em que devem ser apresentados ao ouvinte.
  • No seu caso, as entradas na matriz readingOrder são apenas nomes de arquivos de áudio, já que publication.json e os arquivos de áudio estão no mesmo diretório.
    • Por exemplo, se você colocar os arquivos de áudio em um subdiretório com o nome audio, o URL que representa o arquivo do prólogo será audio/123_1of5.mp3.

Etapa 7: compactar o diretório

Compacte o diretório 123 em um arquivo ZIP chamado 123.zip. As etapas exatas variam de acordo com o sistema operacional, mas confira as instruções para:

• MacOS
• Windows

Etapa 8: renomear o diretório compactado

Mude a extensão de arquivo do diretório compactado de .zip para .lpf". Assim, 123.zip se torna 123.lpf.

Resultado

No exemplo, as etapas acima vão criar um arquivo ZIP com esta estrutura:

123.lpf

├── 123_1of5.mp3

├── 123_2of5.mp3

├── 123_3of5.mp3

├── 123_4of5.mp3

├── 123_5of5.mp3

├── publication.json

└── toc.html

Etapa 9: fazer upload no Google Play Livros

Faça upload de 123.lpf pelo processo de busca automatizada ou na Central de parceiros do Google Play Livros.

Recursos relacionados

• A guia "Configurações"