Guia do Usuário Cancelar

Como usar o ActionScript com o Animate

Pesquisar

Última atualização em 24 de mai de 2023

Apresentação do ActionScript

A linguagem ActionScript® permite que você incorpore ao seu aplicativo maior complexidade de interação, controle de reprodução e exibição de dados. Você pode adicionar o ActionScript no ambiente de autoria, usando o painel Ações, a janela Script ou um editor externo.

O ActionScript segue suas próprias regras de sintaxe e de palavras-chave reservadas, e permite que você use variáveis para armazenar e recuperar informações. O ActionScript inclui uma vasta biblioteca de classes internas que permitem criar objetos para executar muitas tarefas úteis. Para obter mais informações sobre o ActionScript, consulte os seguintes tópicos de Ajuda:

Uso do ActionScript 3.0 em www.adobe.com/go/learn_flcs5_learnas3_br
Uso do ActionScript 2.0 no Adobe Animate em www.adobe.com/go/learn_cs5_learningas2_br

Você não precisa compreender cada elemento do ActionScript para começar a criar scripts. Se você tiver um objetivo claro, poderá começar criando scripts com ações simples.

O ActionScript e o JavaScript estão fundamentados no padrão ECMA-262, o padrão internacional para a linguagem de scripts ECMAScript. Por essa razão, os desenvolvedores que estão familiarizados com o JavaScript se verão automaticamente familiarizados com o ActionScript. Para obter mais informações sobre o ECMAScript, acesse o site ecma-international.org.

Qual versão do ActionScript você pode usar?

O Animate inclui mais de uma versão do ActionScript para atender às necessidades de diferentes tipos de desenvolvedores e hardware de reprodução. ActionScript 3.0 e 2.0 não são compatíveis entre si.

O ActionScript 3.0 é executado de modo rápido. Essa versão requer uma familiaridade um pouco maior com os conceitos de programação orientada a objetos do que as outras versões do ActionScript. O ActionScript 3.0 é totalmente compatível com a especificação ECMAScript e oferece um melhor processamento de XML, um modelo de eventos aperfeiçoado e uma arquitetura aprimorada para trabalhos com elementos de tela. Os arquivos FLA que usam o ActionScript 3.0 não podem incluir versões anteriores do ActionScript.
(Descontinuado apenas no Animate ) O ActionScript 2.0 é mais simples de aprender do que o ActionScript 3.0. Embora o Flash Player execute o código compilado da versão 2.0 mais lentamente do que o código compilado da versão 3.0, o ActionScript 2.0 ainda é útil para vários tipos de projetos. ActionScript 2.0 também é útil para projetos que não demandam muito computacionalmente. Por exemplo, conteúdo mais orientado ao design. O ActionScript 2.0 também é baseado na especificação ECMAScript, mas não é totalmente compatível.
(Descontinuado com o Animate) O ActionScript 1.0 é a forma mais simples do ActionScript e ainda é usado por algumas versões do Adobe Flash Lite Player. O ActionScript 1.0 e o 2.0 podem coexistir no mesmo arquivo FLA.
(Descontinuado com o Animate) O ActionScript do Flash Lite 2.x é um subconjunto do ActionScript 2.0 compatível com o Flash Lite 2.x executado em telefones e dispositivos móveis.
(Descontinuado com o Animate) O ActionScript do Flash Lite 1.x é um subconjunto do ActionScript 1.0 compatível com o Flash Lite 1.x executado em telefones e dispositivos móveis.

Uso da documentação do ActionScript

Como há várias versões do ActionScript (2.0 e 3.0), e várias maneiras de incorporá-lo em seus arquivos FLA, existem vários modos diferentes de aprender a usar o ActionScript.

Você pode localizar a descrição sobre a interface gráfica do usuário para trabalhar com o ActionScript. A interface inclui o painel Ações, a janela Script, o modo Assistência de script, o painel Comportamentos, o painel Saída e o painel Erros do compilador. Os tópicos se aplicam a todas as versões do ActionScript.

Outras documentações do ActionScript da Adobe ajudarão você a saber mais sobre as versões individuais do ActionScript.

Modos de trabalhar com o ActionScript

Há vários modos de trabalhar com o ActionScript.

(Descontinuado com o Animate) O modo Assistência de script permite que você adicione o ActionScript em seu arquivo FLA sem que você mesmo tenha de escrever o código. Você seleciona ações e o software apresenta uma interface do usuário para especificação dos parâmetros necessários a cada ação. Saiba mais sobre quais funções você deve usar para executar tarefas específicas; não será necessário aprender a sintaxe. Muitos designers e não programadores usam este modo.
(Descontinuado com o Animate) Comportamentos também permitem que você adicione códigos em seu arquivo sem que você mesmo tenha de escrever o código. Os comportamentos são scripts pré-gravados de tarefas comuns. Você pode adicionar um comportamento e, depois, configurá-lo facilmente no painel Comportamentos. Os comportamentos só estão disponíveis no ActionScript 2.0 e anteriores.
Escrever o seu próprio ActionScript proporciona a você o maior grau de flexibilidade e controle sobre seu documento, mas requer que você se familiarize com a linguagem e as convenções do ActionScript.
Os componentes são clipes de filme pré-criados que o ajudam a implementar funcionalidade complexa. Um componente pode ser um simples controle da interface do usuário, como uma caixa de seleção, ou um controle complexo, como uma painel de rolagem. Você pode personalizar a funcionalidade e a aparência de um componente e pode fazer download de componentes criados por outros desenvolvedores. A maioria dos componentes exige que você escreva algum código ActionScript próprio para disparar ou controlar um componente. Para obter mais informações, consulte Uso dos componentes do ActionScript 3.0.

Programação de ActionScript

Ao programar código ActionScript no ambiente de autoria, você usa o painel Ações ou a janela Script. O painel Ações e a janela Script contêm um editor de código com recursos completos que incluem referências e atribuições de cores a código, formatação de código, destaque de sintaxe. Também contém depuração, números de linha, quebra de texto e o suporte a Unicode.

Use o painel Ações para escrever scripts que fazem parte de seu documento Animate (ou seja, scripts que estão incorporados no arquivo FLA). O painel Ações fornece recursos como a caixa de ferramentas Ações, que proporciona um rápido acesso aos elementos centrais da linguagem do ActionScript. Você obtém prompts para os elementos que exigem a criação de scripts.
Use a janela Script se você quiser escrever scripts externos, ou seja, scripts ou classes que são armazenados em arquivos externos. (Você também pode usar um editor de texto para criar um arquivo AS externo.) A janela Script inclui recursos de assistência de código como referências e atribuição de cores a código, verificação de sintaxe e formatação automática.

Mais conteúdo recomendado da comunidade

Os artigos e tutoriais a seguir dão mais informações sobre o trabalho com ActionScript:

Tabela de migração do ActionScript 3 (Adobe.com)

Visão geral do painel Saída

Ao testar qualquer tipo de documento, o painel Saída exibe informações ou aviso relativo a operações, como conversões de documento e publicação. Para exibir essas informações, adicione instruções trace() a seu código ou use os comandos Listar objetos e Listar variáveis.

Se você usa a instrução trace() em seus scripts, é possível enviar informações específicas para o painel Saída, conforme o arquivo SWF é executado. Isto pode incluir observações sobre o status do arquivo SWF ou o valor de uma expressão.

O painel Saída consiste nos seguintes itens de menu:

Copiar: copia todo o conteúdo do painel Saída para a área de transferência do computador. Para copiar uma porção selecionada da saída, selecione a área que deseja copiar e, depois, selecione Copiar.
Limpar: limpa o conteúdo do painel Saída.
Mostrar saída: exibe o conteúdo do painel Saída.
Bloquear: bloqueia o painel. É possível apenas redimensionar o painel, mas não movê-lo ou arrastá-lo.
Ajuda: carrega a ajuda online para o painel Saída.
Fechar: fecha o painel Saída.
Fechar grupo: fecha todo o grupo de painéis. Você pode encaixar simultaneamente os vários painéis, como linha do tempo, painel de saída e o painel de erros no compilador.

Para exibir ou ocultar o painel de saída, selecione Janela > Saída ou pressione F2.

Painel Ações

Procurando pela Referência de Linguagem?

Para encontrar a documentação de referência de um elemento de linguagem específico do ActionScript, siga um destes procedimentos:

Abra a Referência de idioma do ActionScript 3.0 e pesquisa pelo elemento de idioma.
Digite o elemento de linguagem no painel Ações, selecione-o e então pressione F1 (pressione F1 imediatamente).

Aprendendo o ActionScript

Para saber mais sobre como programar código ActionScript, use estes recursos:

ActionScript 3.0 e 2.0 não são compatíveis entre si. Escolha somente uma versão para cada arquivo FLA criado.

Visão geral do painel Ações

Para criar scripts incorporados em um arquivo FLA, informe o ActionScript diretamente no painel Ações (Janela > Ações ou pressione F9).

O painel Ações é composto por dois painéis:

Painel Script

Permite que você digite o código do ActionScript, que está associado ao quadro atualmente selecionado.

Navegador de scripts

Lista os scripts no seu documento do Animate e permite movimentação rápida entre eles. Para visualizar o script no painel Script, clique em um item no navegador de Scripts.

O Painel de ações permite que você acesse os recursos de assistência por código, que ajudam a simplificar a codificação no ActionScript. É possível adicionar scripts globais e de terceiros sem quadros que podem ser aplicados em toda a animação no Animate. Para obter mais informações, consulte a seção Adição de scripts globais e de terceiros nesta página.

Executar script: executa o script
Fixar script: fixa o script nas guias de fixação dos scripts individuais no painel Script para movê-lo conforme necessário. Esse recurso é útil se você não tiver organizado o código em seu arquivo FLA em um local central, ou estiver usando vários scripts. Você pode fixar um script para manter o local do código no painel Ações e alternar entre vários scripts abertos. Esse recurso pode ser útil em depurações.
Inserir nome e caminho da ocorrência: ajuda a configurar o caminho de destino absoluto ou relativo para uma ação no script.
Localizar: localiza e substitui textos no script.
Formatar código: ajuda para formatar o código.
Snippets de código: abre o painel Snippets de código, que exibe amostras de snippets de código.
Adicionar usando o assistente: clique nesse botão para adicionar ações usando um assistente fácil de usar, sem ter que escrever código.
Ajuda: exibe as informações de referência para o elemento do ActionScript que está selecionado no painel Script. Por exemplo, se você clicar em uma instrução import e, em seguida, clicar em Ajuda, as informações de referência para import serão exibidas no painel Ajuda.

Usar o assistente de códigos para ações

É possível adicionar interatividade a composições HTML5 com as opções Adicionar usando o assistente no painel Ações. Adicionar usando o assistente é uma interface de usuário simplificada para acrescentar códigos às suas composições.

Crie um novo documento HTML5 Canvas e clique em Janela > Ações.
Clique em Adicionar usando o assistente no painel Ações, como mostrado no instantâneo a seguir.

Painel Ações com o botão Adicionar usando o assistente
Selecione uma ação para a qual deseja criar um código usando o assistente de código.

Um exemplo de captura de tela mostrando as opções do assistente de código de ação para ações

No instantâneo acima, a ação Obter número do quadro está selecionada e o código correspondente foi atualizado na janela de ações.

Com base no tipo de ação selecionado, você também pode escolher o objeto correspondente para o qual deseja aplicar a ação. É possível pesquisar por objetos específicos no palco se o objeto tiver um nome de ocorrência. Além disso, é possível aplicar a ação na seleção atual.

Lista de objetos para aplicar a ação
Clique em Próximo para escolher um evento de acionamento. Um conjunto de eventos de acionamento é listado na janela com base no tipo de ação e no tipo de objeto selecionados nas etapas anteriores.

Lista de eventos de acionamento
Escolha um evento de acionamento apropriado seguido por seus objetos de acionamento correspondentes, se houver, e clique no botão Concluir e adicionar .

É possível escolher a opção Seleção atual no menu ao selecionar o objeto no palco e executar o assistente de códigos de ações. Também é possível escolher a linha do tempo e as ações de componentes para o código.

Aumentar a interatividade de uma animação

A interatividade é uma parte essencial da animação que impulsiona a experiência visual do público-alvo. Quer saber como inserir ações ao vídeo sem códigos? Assista ao tutorial no fim deste exemplo e siga estas etapas.

Na Linha do tempo, selecione o clipe de ação.
Clique em Janela > Ações.
Clique em Aadicionar usando o assistenteno painel Ações.
No quadro atual, selecione as seguintes opções:
- Selecione uma ação: selecione Reproduzir.
- Objeto no qual aplicar a ação: selecione o objeto necessário.
Clique em Avançar.

Como adicionar interatividade às animações

Assista ao vídeo para saber mais sobre ações como reprodução, mover verticalmente e posição do objeto.

Usar a janela de script

A janela Script permite criar arquivos externos de script, que podem ser importados para seu aplicativo. Esses scripts podem ser arquivos do ActionScript ou do Animate JavaScript.

Você também pode adicionar scripts globais e de terceiros em documentos do HTML5 Canvas. Para obter mais informações, consulte a seção Adição de scripts globais e de terceiros em Criar e publicar documentos HTML5 Canvas no Animate

Se você tem mais de um arquivo externo aberto, os nomes de arquivos são exibidos em guias no topo da janela Script.

Na janela Script, é possível usar PinScript, localizar e substituir, cor de sintaxe, código de formato, referências de código, comentários e recursos de recolhimento de código. Você também pode usar as opções de depuração (apenas para arquivos do ActionScript) e quebra de linha. A janela Script também permite a exibição de números de linha e de caracteres ocultos.

Criar um arquivo externo na janela Script

Selecione Arquivo > Novo.
Selecione o propósito desejado nas guias da parte superior da tela, como Animação de personagem, Social, Jogos, Ensino, Anúncios, Web e Avançado. Selecione o tipo do arquivo externo que você deseja criar (arquivos ActionScript ou Animate JavaScript).

Editar um arquivo existente na janela Script

Para abrir um script existente, selecione Arquivo > Abrir e, depois, abra um arquivo AS existente.
Para editar um script que já esteja aberto, clique a guia do documento que exibe o nome do script.

Ferramentas no painel Ações e na janela Script

O painel Ações permite que você acesse os recursos de assistência de código que ajudam a simplificar e dinamizar a codificação no ActionScript.

Localizar

Localiza e substitui texto no script.

Inserir caminho de destino

(Somente painel Ações) Ajuda na configuração do caminho de destino absoluto ou relativo para uma ação no script.

Ajuda

Exibe as informações de referência para o elemento do ActionScript que está selecionado no painel Script. Por exemplo, se você clicar em um instrução import e, em seguida, clicar em Ajuda, as informações de referência para import aparecem no painel Ajuda.

Snippets de código

Abre o painel Snippets de código que exibe amostras de snippets de código.

Adicionar usando o assistente

Ajuda a adicionar o código para ações usando uma interface sem precisar escrever código.

Acessar a Ajuda sensível ao contexto do painel Ações

Para selecionar um item de referência, realize um dos seguintes procedimentos:
- Selecione um termo ActionScript no painel da caixa de ferramentas do painel Ações (à esquerda do painel Ações).
- Selecione um termo ActionScript no painel Ações no painel Script.
- Coloque o ponto de inserção antes do termo ActionScript no painel Ações no painel Script.
Para abrir a página de referência do painel de Ajuda do item selecionado, realize um dos seguintes procedimentos:
- Pressione F1.
- Clique com o botão direito no item e selecione Exibir Ajuda.
- Clique em Ajuda sobre o painel Script.

Definir preferências do ActionScript

Quer você edite o código no painel Ações ou na janela Script, você pode definir e modificar um único conjunto de preferências.

Selecione Editar > Preferências (Windows) ou Animate > Preferências (Macintosh) e, depois, clique em Editor de código na lista Categoria.
Defina as preferências desejadas:

Recuo automático

Quando o recuo automático está ativado, o texto digitado após um parêntese de abertura “(“ é automaticamente recuado de acordo com a configuração do Tamanho da tabulação. Esse comportamento também é aplicável ao usar o colchete de abertura “(“.

Tamanho da tabulação

Especifica o número de caracteres que uma linha é recuada.

Referências de código

Ativa a referência de código no painel Script.

Atraso

Especifica o atraso (em segundos) antes que as referências de código sejam exibidas. A opção foi descontinuada no Animate.

Fonte

Especifica a fonte usada em seu script.

Abrir/importar

Especifica a codificação de caractere usada quando você abre ou importa arquivos do ActionScript.

Salvar/exportar

Especifica a codificação de caractere usada quando você salva ou exporta arquivos do ActionScript.

Recarregar arquivos modificados

Especifica o que acontece quando um arquivo de script é modificado, movido ou excluído. Selecione Sempre, Nunca ou Prompt.

Sempre

Nenhum aviso é exibido, e o arquivo é automaticamente recarregado.

Nunca

Nenhum aviso é exibido, e o arquivo permanece no estado atual.

Solicitar

(Padrão) É exibido um aviso, e você pode optar por recarregar o arquivo.

Quando você cria aplicativos com scripts externos, essa preferência permite evitar a substituição de um script. Ou evite publicar o aplicativo com versões mais antigas dos scripts. Os avisos permitem que você feche automaticamente um script e reabra a versão modificada mais recente.

Cores de sintaxe

Especifica a atribuição de cores a códigos em seus scripts.

Configurações do ActionScript 3.0

Esses botões abrem as caixas de diálogo Configurações do ActionScript, onde você pode definir um caminho de origem, caminho de biblioteca e caminho de biblioteca externa para o ActionScript 3.0.

Mais itens similares

Receba ajuda com mais rapidez e facilidade

Novo usuário?