Como encontrar um conceito em uma aula longa no YouTube

1. Primeiro, escreva a pergunta de estudo

Escreva uma frase antes de examinar a transcrição. Diga qual é a ideia. Acrescente outras palavras que um professor pode usar. Indique o tipo de resposta de que você precisa.

Use estes tipos de resposta:

• Uma definição diz o que a ideia significa ou como colocá-la em prática.
• Um exemplo resolvido apresenta a resolução de um caso passo a passo.
• Uma sequência de etapas mostra ações em ordem.
• Uma comparação apresenta 2 ideias lado a lado.
• Um limite diz até onde a ideia se aplica.

Mantenha uma distinção clara. "Menciona medição" não é o mesmo que "explica como medir". Sua frase deve dizer de qual dessas respostas você precisa.

2. Obtenha uma faixa de legendas

Uma legenda é um texto com marcação de tempo já armazenado para o vídeo. Uma transcrição reúne todas essas legendas de um vídeo. Um segmento é uma linha com marcação de tempo. Cada segmento tem texto, início e duração. A duração indica quanto tempo essa linha permanece.

Um intervalo é o início e o fim que você escolhe para um conceito. Você o escolhe depois de ler os segmentos.

Um Actor é um programa hospedado que coleta registros da fonte. Um registro da fonte é um resultado de vídeo. Uma Task é uma configuração de entrada salva. O Actor apenas coleta registros. Você faz o trabalho sobre os conceitos nesses registros.

Use o YouTube Transcript na versão 0.1.43. O Actor é o YouTube Transcript Scraper. A Task pública é a YouTube Transcript Data for Video Chapter Generation.

Essa Task é uma configuração de entrada inicial. Ela não rotula os conceitos para você. A lista salva contém vídeos de exemplo, não a sua aula. Substitua a lista inteira por um vídeo de aula público que você já conhece. Não estude a lista de exemplo. Não copie palavras dela.

O Actor aceita a URL de um vídeo público. Ele também aceita um ID de vídeo com 11 caracteres. Um ID é o código curto do vídeo. Você pode enviar até 1.000 entradas. Para este trabalho, envie 1 vídeo. Um ID de vídeo repetido é processado 1 vez.

Uma URL inicial pode ser um link normal de exibição, um link youtu.be, um link de Shorts, um link de transmissão ao vivo ou um link de incorporação. Um link de incorporação coloca o player em outra página. O Actor não encontra vídeos a partir de um canal, uma playlist ou uma página de busca.

Ele lê apenas legendas públicas existentes. Ele não converte fala em texto novo. Não traduz. Não escreve capítulos, rótulos nem resumos.

Use esta entrada quando quiser uma faixa em inglês:

{
  "startUrls": ["https://www.youtube.com/watch?v=YOUR_PUBLIC_VIDEO"],
  "preferredLanguages": ["en"],
  "outputFormats": ["json"],
  "includeFailedInputDetails": true
}

Substitua YOUR_PUBLIC_VIDEO pelo vídeo público que você conhece. `outputFormats` deve ser `["json"]` para que cada segmento mantenha suas marcações de tempo. Definir `preferredLanguages` como `["en"]` solicita inglês. Se não houver inglês, o resultado informa que o idioma está indisponível. Ele não retorna outro idioma sem avisar.

Se quiser a melhor faixa disponível, use uma lista de idiomas vazia:

{
  "startUrls": ["https://www.youtube.com/watch?v=YOUR_PUBLIC_VIDEO"],
  "preferredLanguages": [],
  "outputFormats": ["json"],
  "includeFailedInputDetails": true
}

Uma lista vazia não garante inglês. Você deve ler `transcriptLanguageCode` após a execução. Mantenha `includeFailedInputDetails` como true para que uma entrada com falha permaneça visível.

3. Verifique o resultado antes de buscar

Leia estes nomes em um registro da fonte. Um campo é um valor identificado por um nome.

• `videoId`
• `videoUrl`
• `transcriptLanguageCode`
• `isAutoGenerated`
• `segments`, cada um com `text`, `startSeconds`, `endSeconds` e `durationSeconds`
• `segmentCount`
• `status`
• `statusReason`
• `scrapedAt`

`videoDurationSeconds` pode estar ausente. A ausência significa que o valor é desconhecido. Não registre um valor desconhecido como 0.

`isAutoGenerated` informa como a faixa foi criada. Verdadeiro significa que as legendas foram criadas automaticamente. Falso significa que uma pessoa forneceu a faixa. Uma faixa manual ainda pode conter palavras erradas. Você ainda precisa assistir ao vídeo.

`status` informa se a leitura das legendas funcionou. `statusReason` informa o motivo. `scrapedAt` é o momento da observação. Mantenha o ID do vídeo, a URL, o idioma, o indicador de faixa automática ou manual e `scrapedAt` junto das suas anotações.

Depois, leia o resumo da execução, chamado OUTPUT:

• `successfulTranscriptRows`
• `rowsWritten`
• `failedInputs`
• `statusCounts`
• `errorCodeCounts`
• `failedInputDetails`

Uma entrada com falha não se torna um registro de transcrição. Se `status` não indicar sucesso, pare. Se o idioma solicitado estiver indisponível, deixe a busca sem conclusão. Não encontrar uma correspondência no texto não comprova que o conceito está ausente. As palavras podem aparecer apenas na tela. A faixa no idioma correto pode estar ausente. A leitura das legendas pode ter falhado. Essa limitação se aplica apenas à faixa verificada, não ao vídeo inteiro.

Um teste da versão 0.1.43 usou 1 ID exato de vídeo público. Ele retornou 1 transcrição. A faixa era em inglês e manual. Ela tinha 4.530 segmentos com marcação de tempo. OUTPUT indicou sucesso e não mostrou entradas com falha. Isso comprova a obtenção de segmentos com marcação de tempo para essa única fonte. Não comprova rótulos de conceitos. Não comprova que todas as palavras estejam corretas. Não comprova o mesmo resultado para todos os vídeos. Confira cada intervalo no vídeo.

`transcriptSpanSeconds`, junto dos primeiros e últimos valores de tempo, descreve apenas a faixa de legendas. Esses valores não comprovam que um conceito foi apresentado por completo.

4. Mantenha cada segmento original

Mantenha todos os segmentos originais. Não transforme cada palavra das legendas em um conceito separado. Procure seu conceito e as outras palavras que você listou. Depois, leia os segmentos imediatamente anteriores e posteriores a uma ocorrência.

Uma busca por palavra-chave pode sugerir um candidato. Um candidato é um possível intervalo, ainda não confirmado. A busca não produz um rótulo verificado. Você só escreve o rótulo depois de assistir.

5. Marque o intervalo candidato

Comece o intervalo no primeiro segmento que inicia a explicação. Termine no último segmento que ainda responde à sua pergunta.

Dê preferência ao `endSeconds` retornado para esse último segmento. Quando `durationSeconds` for conhecido, confira se `endSeconds` é igual a `startSeconds` mais `durationSeconds`. `durationSeconds` pode ser null mesmo quando `endSeconds` é conhecido. Preserve null. Nunca presuma 0. Não use o início do próximo segmento como fim. Os segmentos podem se sobrepor. Os segmentos também podem deixar lacunas. O fim da última legenda não é o fim do vídeo.

Inclua segmentos anteriores quando eles definirem uma palavra de que você precisa. Uma palavra definida pode ser o nome de um valor. Os intervalos podem se sobrepor quando o professor retoma uma ideia anterior. Você não precisa dividir o vídeo inteiro em um único conjunto contínuo de intervalos.

6. Assista ao vídeo e rotule a resposta

Abra o intervalo candidato no vídeo de origem. Ouça as palavras. Observe também os diagramas, o código na tela e as referências. As legendas podem não registrar esses elementos.

Atribua 1 rótulo deste esquema simples:

• `mention_only` significa que a ideia é citada, mas não explicada.
• `explains_definition` significa que o intervalo explica o significado ou o método.
• `worked_example` significa que o intervalo apresenta a resolução de um caso passo a passo.
• `comparison` significa que o intervalo faz uma comparação.
• `unresolved` significa que você não consegue confirmar a resposta ao assistir a esse trecho.

Esses rótulos são suas próprias marcações de conteúdo. Eles não são resultados do Actor. Escreva por que o intervalo responde à pergunta de estudo ou por que não responde.

7. Salve 1 registro no índice

Um registro do índice é uma linha que você escreve para 1 intervalo verificado. Inclua:

• rótulo do conceito
• pergunta de estudo
• ID e URL do vídeo
• idioma das legendas
• início e fim em segundos
• tempo de início em minutos e segundos
• tipo de explicação
• `checked_at`
• nota sobre as evidências
• grau de confiança

Mantenha também o tempo de fim. O grau de confiança é a avaliação que você declara após a verificação. Não é uma pontuação de modelo. Se um limite do intervalo for desconhecido, mantenha-o como desconhecido.

8. Abra o link de início e estude esse intervalo

Em um computador, abra Compartilhar e depois Iniciar em. Insira o tempo de início. Copie o link. Abra o link copiado. Confirme que a reprodução começa perto do contexto correto. O YouTube explica esse controle em Compartilhar vídeos e canais.

Um link de início não obriga a reprodução a parar em um tempo definido. Mantenha o tempo de fim no índice. Não trate uma URL de exemplo inventada como um vídeo verificado que pode ser reproduzido.

Use o intervalo verificado para estudar. Se não conseguir confirmar a explicação, marque `no_confirmed_explanation_in_checked_track`. Acrescente uma nota sobre o escopo que identifique a faixa verificada. Depois, consulte outra fonte. Não conclua que o vídeo inteiro é incapaz de responder porque uma busca incerta nas legendas falhou.

Aula fictícia: Medindo um canteiro

O exemplo abaixo é uma ficção original. Ele ensina os cálculos de intervalos. Não é um resultado do Actor. Ele não tem uma URL de vídeo real. Não trate nenhum link para ele como algo que pode ser reproduzido.

O título fictício é "Medindo um canteiro". A aula inventada tem 12 minutos de duração. Seus intervalos de ensino são:

• preparação de 0 a 120 segundos
• explicação da medição de 120 a 330 segundos
• um exemplo de cálculo de 330 a 570 segundos
• limitações de 570 a 720 segundos

Há 3 segmentos fictícios próximos à apresentação do conceito de largura:

A pergunta de estudo é: Como medir a largura usando uma única unidade de medida?

A linha em 120 segundos apresenta a ação. A linha em 150 segundos acrescenta o uso de uma única unidade de medida. A linha em 300 segundos encerra o método. Portanto, o intervalo da definição inclui as 3 linhas. Ele vai de 120 segundos até 330 segundos.

Fim do último segmento: 300 + 30 = 330 segundos. Duração do intervalo: 330 - 120 = 210 segundos. 210 segundos equivalem a 3 minutos e 30 segundos. A marcação de início é 2:00. A marcação de fim é 5:30.

Após assistir manualmente a essa aula fictícia, o rótulo é `explains_definition`. A nota sobre as evidências diz que as bordas internas são mostradas. É a etapa de assistir que confirma o rótulo. O texto dos segmentos, por si só, não confirma.

O intervalo de cálculo é um tipo diferente de conceito. Ele vai de 330 a 570 segundos. 570 - 330 = 240 segundos. 240 segundos equivalem a 4:00. Sua marcação de início é 5:30. Rotule-o como `worked_example`. Não o una à definição.

As durações dos 4 intervalos de ensino são 120, 210, 240 e 150 segundos. 120 + 210 + 240 + 150 = 720 segundos. Juntos, eles cobrem esta aula fictícia. Cobrir todo o tempo não significa que todos os conceitos sejam explicados.

A palavra medição também aparece em 600 segundos. Essa marcação de tempo é 10:00. Ela está dentro do intervalo de limitações e faz parte de um alerta. Mantenha-a como `mention_only` ou como um limite. Não transfira a definição principal para 600.

Mais um limite de intervalo na ficção exige uma escolha manual. Um segmento começa em 310 segundos e tem duração de 30 segundos. Seu fim é 310 + 30 = 340 segundos. O próximo intervalo começa em 330 segundos. 340 - 330 = 10 segundos de sobreposição. Mantenha essa sobreposição ou mova o limite depois de assistir. Não corte as palavras em 330 apenas para deixar o limite exato.

`scrapedAt` é desconhecido aqui porque nenhuma faixa real foi lida. `videoDurationSeconds` também é desconhecido. Os 720 segundos vêm das durações inventadas. Eles não são um campo de duração do vídeo. O que é desconhecido permanece desconhecido.

Cálculos de tempo para os 4 intervalos fictícios

Casos de limites de intervalo na mesma ficção

Índice verificado da aula fictícia

A pergunta sobre largura seleciona o registro de 120 a 330. Você assistiria a partir de 2:00 e usaria 5:30 como fim da verificação. Você salvaria o link de início, o tempo de fim e a nota sobre as evidências. Esse registro fictício não tem um link real. Em um vídeo real, use Compartilhar e depois Iniciar em, abra o link copiado e escreva o que viu.

Esta ficção não apresenta nenhum resultado medido de velocidade de estudo. Os números ensinam apenas os cálculos de intervalos.