Vídeo de Treinamento de Software em Árabe

Vídeo de Guia do Usuário de Software em Árabe

Transforme a interface e a documentação de um aplicativo existente em um passo a passo prático que pode ser revisado e editado. Cada instrução deve fazer referência a um elemento real da interface. Cada alegação de qualidade deve ser apoiada por uma verificação real.

Estabelecer escopo e referências

• Leia a solicitação do usuário e os anexos antes de escolher um estilo de produção. Identifique o idioma ou dialeto, a marca, os entregáveis e os limites na exibição de dados.
• Inspecione o vídeo anterior, a narração de origem, as legendas e o tempo quando disponíveis. Diferencie o roteiro de origem aprovado de uma transcrição inferida do áudio.
• Trate o aplicativo atual como a autoridade para funcionalidades, nomes de campos, botões e rotas. Use imagens fornecidas e modelos oficiais como referências visuais.
• Reutilize um projeto de produção editável quando disponível, em vez de recapturar material correto desnecessariamente.
• O Árabe Padrão Moderno é o padrão para material institucional em árabe. Respeite uma solicitação explícita por outro dialeto; não misture estilos dentro da mesma versão.
• Uma solicitação de produção de vídeo não autoriza alterações no código do aplicativo, permissões, rede ou dados de produção, publicação ou envio de material para outras pessoas.

Escolher ferramentas disponíveis

Use ferramentas que estão realmente disponíveis. Não presuma que existe um serviço de voz, chave de API ou GPU.

Ferramenta	Propósito
Python e um ambiente virtual	Organizar e executar o pipeline de produção
Playwright + Chromium	Capturar a interface real e testar a reprodução
Pillow	Quadros, títulos, camadas, ponteiro e posições de foco
NumPy	Processamento de áudio ou música procedural original
FFmpeg, localmente ou através de imageio-ffmpeg	Movimento, composição, codificação e processamento de áudio
edge-tts ou um provedor autorizado	Narração e temporização de limites de palavras
arabic-reshaper e python-bidi	Fallback de formatação árabe quando RAQM não está disponível
PyAV	Duração de mídia, contagens de quadros e verificações de clipes
faster-whisper	Transcrição local opcional para revisão quando os recursos permitem
openpyxl	Registros de pronúncia e revisão
HTML/Chromium ou uma ferramenta PDF adequada	Relatório de qualidade árabe legível

Verifique a compatibilidade Python/pacote antes de instalar as dependências. Use um ambiente isolado e registre as versões. Obtenha fontes de suas fontes oficiais e preserve as licenças.

Criar um storyboard editável

Use dados estruturados, como storyboard.json. Para cada etapa, registre:

• Capítulo, título da etapa, roteiro falado e captura necessária.
• O elemento a destacar e se o movimento ilustra uma captura de tela ou grava uma ação real.
• A evidência que apoia a instrução, qualquer período de espera e o resultado real, quando aplicável.

Escreva frases curtas que expliquem uma ação de cada vez. Mantenha os rótulos da interface conforme exibidos. Não leia cada palavra visível para preencher o tempo, nem omita explicações necessárias para encurtar o vídeo.

Aplique diacríticos árabes parciais a palavras ambíguas, especialmente nomes de produtos, nomes de organizações e termos técnicos. Mantenha um dicionário de pronúncia editável. Apenas os diacríticos do texto não provam que a fala gerada é pronunciada corretamente.

Capturar a interface e proteger dados

1. Capture a interface real em uma resolução que suporte zoom legível. Use uma proporção de pixels de dispositivo adequada, em vez de upscaling por IA.
2. Salve os retângulos dos elementos alvo e os deslocamentos de corte junto com as capturas, juntamente com as dimensões da viewport e a proporção de pixels do dispositivo.
3. Revise rótulos, valores, dicas de ferramentas, links e a conta visível, não apenas os campos preenchidos.
4. Use um ambiente de treinamento ou mascaramento documentado na visualização. Não altere dados de produção apenas para criar uma captura de tela segura.
5. Rotule as informações substituídas como exemplos. example.org e 192.0.2.10 podem substituir links e endereços operacionais.
6. Movimento do ponteiro ou zoom sobre uma captura de tela estática é uma ilustração, não uma gravação ao vivo. Descreva-o com precisão.
7. Para capturar um salvamento bem-sucedido genuíno, use um ambiente de teste isolado autorizado e verifique primeiro o destino da gravação. Limpe os registros de teste depois. Se não estiver disponível, explique o procedimento sem fabricar uma mensagem de sucesso.

Não envie capturas de tela ou dados do aplicativo para um provedor de narração. Envie apenas o texto explicativo geral, respeitando as restrições do usuário sobre processamento externo.

Narração e legendas em árabe

• Verifique a disponibilidade da voz e teste uma passagem representativa. Um identificador de voz regional não estabelece por si só o dialeto, o árabe formal ou a entrega natural.
• Retenha texto aprovado, áudio e limites de palavras para cada segmento. Regere apenas segmentos alterados.
• Derive chaves de cache de áudio do texto, voz, taxa e configurações de pronúncia; a existência do arquivo por si só não é uma chave de cache válida.
• Construa SRT a partir do roteiro aprovado, retendo a pontuação, e alinhe suas palavras com os limites de tempo. Não monte tokens brutos de transcrição e perca a pontuação.
• Documente o tempo estimado onde o alinhamento exato não está disponível. Não o descreva como verificação precisa baseada em audição.
• Verifique a renderização em árabe. Prefira a formatação nativa com RAQM; use reshaper/bidi apenas quando necessário. Não molde ou inverta o texto duas vezes.
• Teste a fonte com árabe, números e texto técnico misto. Evite subconjuntos de fontes incompletos.
• Posicione as legendas fora da área de ação importante. Mantenha-as legíveis no tamanho de um telefone e, preferencialmente, dentro de uma ou duas linhas.

Movimento e marca

• Extraia cores, fontes e logotipos do projeto real. Use o logotipo original sem redesenhar ou recolorir.
• Mostre a instrução atual claramente em vez de aglomerar todas as instruções em torno de uma pequena captura de tela.
• Aplique zoom progressivo na ação, preservando a proporção da imagem e todo o campo ou botão relevante.
• Use um ponteiro claro, movimento suave e uma breve indicação de clique onde for útil. Alinhe o clique com a instrução falada correspondente.
• Mantenha as transições calmas. Evite tremores, flashes e zoom repetido sem propósito.
• Quando uma introdução e um encerramento forem solicitados, use a mesma identidade e revele o logotipo, a organização e o título progressivamente. Durações como 8 a 12 segundos são exemplos, não requisitos universais.
• Não apresente um slogan proposto como um slogan oficialmente aprovado.

Setas: cor, posicionamento e movimento

Estas são as configurações padrão de produção recomendadas, não alegações sobre todos os vídeos existentes. Adapte-as à densidade do aplicativo e à referência do usuário, mantendo um estilo de anotação consistente em toda a entrega.

Aparência

• Use vermelho #D52424 para a seta instrutiva, com um contorno branco #FFFFFF para separá-la de interfaces claras e escuras. Mantenha as cores e o logotipo do aplicativo inalterados.
• Em 1920×1080, comece com uma haste de 5 px, contorno branco de 2 px, ponta de seta de 18 px e comprimento total de aproximadamente 90–160 px. Escale esses valores proporcionalmente à resolução de saída e verifique a legibilidade no tamanho de um telefone.
• Uma pequena sombra preta com aproximadamente 18% de opacidade e desfoque de 3 px é opcional. Não adicione brilho neon, efeitos 3D pesados, emoji ou um glifo de seta de texto. Desenhe a anotação como um caminho vetorial limpo ou uma camada transparente de alta resolução.
• Diferencie a seta do tutorial do ponteiro real do mouse: a seta explica o alvo; o ponteiro indica navegação ou um clique real. Evite mostrar ambos quando obscurecerem o mesmo controle.

Posicionamento e coordenadas

• Aponte para a borda do botão, campo ou link real, deixando cerca de 6–12 px de folga em Full HD. Não cubra seu rótulo, valor digitado, ícone, contorno de foco, mensagem de validação ou legendas.
• Prefira um caminho diagonal ou curvo curto a partir do espaço vazio próximo. Exiba uma seta instrutiva por ação. Para várias ações, revele as setas sequencialmente em vez de deixar uma coleção na tela.
• Salve um retângulo alvo e uma âncora relativos à captura de origem. Aplique o mesmo corte, escala, panorâmica e transformação de zoom à ponta da seta que à captura de tela. Nunca codifique uma coordenada fixa de tela para um zoom em movimento.
• Antes de zoom/pan adicional, um mapeamento simples de corte e escala é screenX = offsetX + scale * (sourceX - cropX) e da mesma forma para Y. Aplique qualquer transformação de animação posterior também e verifique o quadro codificado real.
• RTL/LTR afeta o layout do texto da anotação, não a localização real do alvo. Não espelhe uma seta automaticamente apenas porque o idioma da narração muda.

Tempo e movimento

1. Deixe a tela relevante se estabelecer. Desvaneça a seta em aproximadamente 0,15–0,25 segundos.
2. Se o movimento ajudar a explicar a ação, mova a ponta em direção ao seu alvo uma vez, em aproximadamente 0,35–0,65 segundos, usando movimento suave. Não quique, balance, gire ou repita o movimento continuamente.
3. Uma função de easing útil é e = (1 - cos(pi * u)) / 2, onde u é o progresso decorrido limitado a 0–1. Interpole a posição usando p = start + (end - start) * e. Para um caminho curvo, avalie a curva no progresso suavizado e oriente a ponta da seta ao longo de sua tangente.
4. Complete o movimento quando o narrador nomear o alvo ou disser "clique aqui." Derive essa dica da linha do tempo da narração ou de um limite de palavra revisado; não aplique o mesmo atraso arbitrário a cada cena.
5. Mantenha a seta parada enquanto o visualizador lê o controle e ouve a instrução. Uma espera de 1 a 2 segundos pode ser um ponto de partida, mas a instrução falada e a legibilidade do alvo determinam a duração real.
6. Se representar um clique, mostre um único anel sutil por cerca de 0,3–0,5 segundos no alvo, sincronizado com a dica. Essa anotação não deve implicar que uma ação real ou salvamento bem-sucedido ocorreu quando não ocorreu.
7. Desvaneça a seta em aproximadamente 0,15–0,25 segundos antes de alternar alvos ou cenas. Em uma versão de movimento reduzido, substitua o deslocamento/zoom por uma seta estática e um desvanecimento suave; evite pulsar ou piscar.

Armazene cor, dimensões, retângulo de origem, âncora, caminho, dica, duração de entrada, espera e duração de saída em configurações de storyboard/renderização editáveis. Visualize a seta no início, durante o zoom, na dica e no final. Confirme que ela permanece anexada ao elemento correto, dentro do quadro e legível em ambos os temas, sem ocultar legendas ou conteúdo da interface.

Áudio e música

Use música original ou devidamente licenciada, retendo sua fonte ou método de geração. Não imite uma composição protegida específica.

Normalize a narração e evite clipping. Se a música acompanhar a fala, faça ducking de acordo com o sinal da narração, em vez de presumir que um nível fixo é suficiente. Evite redução de ruído em fala digital limpa quando isso danificar as consoantes.

Mantenha as configurações de narração, música e mixagem separadas para edição. Não acelere a fala para atender a uma duração arbitrária; ajuste as cenas para caber na explicação.

Detalhes de tempo e codificação

• Meça o áudio usando PCM/WAV ou contagens de amostras, em vez de duração estimada de MP3.
• Construa a linha do tempo final a partir dos comprimentos reais dos clipes codificados ou durações arredondadas para a grade de quadros. Inclua separadores de capítulo e leads/outs de áudio.
• Vincule SRT e limites de capítulo à linha do tempo final, não a uma linha do tempo anterior com desvio de arredondamento cumulativo.
• Inspecione as opções da versão do FFmpeg instalada. Não presuma que filter_complex_script existe; passe o gráfico de filtros diretamente quando apropriado.
• Escreva durações decimais como 0.65 em vez de .65 para filtros que rejeitam este último.
• Use caminhos explícitos e argumentos de subprocesso estruturados. Não construa comandos shell a partir de narração ou títulos de capítulos.
• Invalide caches de renderização quando imagens, retângulos alvo, fontes, logotipos ou código de layout mudarem.
• Ao exportar capítulos independentes, inspecione os limites dos keyframes e os inícios de áudio. Verifique os próprios arquivos extraídos.

Revisão de qualidade e aprovação verdadeira

Execute verificações apropriadas ao material:

• Decodifique o vídeo/áudio completo e verifique resolução, taxa de quadros, duração e faixas.
• Meça o loudness e os níveis de pico; verifique se há lacunas e clipping.
• Compare as legendas com o roteiro aprovado e valide a ordem do tempo e os limites finais.
• Inspecione quadros da renderização final real, incluindo introdução, encerramento, zooms, mensagens de validação e estados de sucesso.
• Teste a reprodução e a busca em um navegador ou player adequado, incluindo uma visualização em tamanho de telefone.
• Confirme que cada elemento referenciado existe, o alvo do foco está correto e o texto importante não está cortado.
• Valide PDF, XLSX, clipes independentes e conteúdo do arquivo quando solicitado.

A transcrição automática não é audição. O ASR pode identificar passagens que precisam de revisão, mas as discrepâncias podem ser erros de reconhecimento ou diferenças ortográficas.

Registre as verificações técnicas, a comparação automatizada de texto, a audição documentada e a aprovação formal separadamente. Nunca marque a audição ou aprovação como concluída a menos que tenha acontecido.

Se a audição direta ou humana necessária não estiver disponível, afirme isso claramente. Entregue os arquivos suportados e um registro de revisão de audição segmento por segmento; não reivindique pronúncia impecável. Não relate uma alteração baseada em ASR como uma correção de audição confirmada.

O registro de pronúncia deve incluir timestamp, segmento, texto aprovado, transcrição ou palavra sinalizada, correção solicitada e status de audição/resolução.

Entrega

Siga os nomes e formatos solicitados. Uma entrega completa pode incluir:

• MP4 principal e introdução/encerramento separados.
• WAV de narração, SRT em árabe e timestamps de capítulos.
• XLSX de revisão de pronúncia e relatório de qualidade em PDF mostrando itens verificados e pendentes.
• Storyboard, capturas seguras, fontes/licenças, ativos de áudio, código de edição e informações de dependência.
• Clipes de capítulos independentes quando útil.

Mantenha o projeto de edição portátil; exclua caminhos de máquina do desenvolvedor e credenciais de login. Inspecione o pacote antes de criar um arquivo. Vincule apenas arquivos que existem e declare as limitações do material sem reivindicar trabalho não realizado.