Como um script funciona

Conferido na fonte e no computador · APK 0.4.0 · API e fluxo de compilação conferidos na fonte

Um script da Astra é um componente C#: uma classe que herda de Behavior e é adicionada a um objeto como qualquer outro componente.

Criar e ligar

1. No painel Arquivos, toque o ícone de código › Novo componente C#.
2. Escreva o código, toque Salvar tudo e Recompilar projeto. Erros aparecem no console do espaço Código.
3. No objeto, Adicionar componente › Scripts do projeto › o seu script.

O Play só começa com a compilação em dia (“Aguarde a compilação antes de Play”).

O esqueleto

using Astra;
using Astra.Components;

[ComponentId("meujogo.girar")]          // identidade única no projeto
public sealed class Girar : Behavior
{
    [PropertyId("graus_por_segundo")]    // aparece no Inspector
    public float GrausPorSegundo = 90;

    public override void Start() { }                 // uma vez, ao começar o Play
    public override void Update(float seconds) { }   // a cada quadro
    public override void FixedUpdate(float seconds) { } // a cada passo da física
    public override void Disable() { }               // quando o componente é desligado
}

Achar e mudar componentes

Object.GetComponent<T>() devolve o componente do mesmo objeto, ou nada:

if (Object.GetComponent<Light>() is { } luz)
    luz.Intensity = 2;

Cada componente nativo tem uma fachada com os campos do Inspector (por exemplo Light, TimeOfDay, Weather). A lista completa está na Referência C#.

Entrada e registro

• Input.Pressed("Saltar") diz se a ação está apertada; as ações vêm de Configurações do projeto › Entrada.
• Scene.Log(ObjectId, "mensagem") escreve no console.

Exemplo completo com entrada: o script Correr do Fazer um player.