---
title: "Astra.GameViewAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-gameviewaccess/
---

# Astra.GameViewAccess

A vista de jogo como no Unity 6000.0 Screen e Camera: pixels com origem no canto inferior esquerdo, câmera = a que produziu o quadro (a autorada de maior prioridade; sem ela, a do editor).

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.GameViewAccess
```

A vista de jogo como no Unity 6000.0 Screen e Camera: pixels com origem no canto inferior esquerdo, câmera = a que produziu o quadro (a autorada de maior prioridade; sem ela, a do editor).

## Onde acessar este tipo

Configure Câmera, Olhar/Acompanhar alvo na cena. No Behavior, **View** fornece viewport/área segura e conversões. Uma leitura de View não configura automaticamente layout de UI.

## Roadmap e uso

[Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [ScreenPointToRay](#member-84cd2f12e87c77fb) | Method |
| [TryGetSafeArea](#member-de4ce83f4fa269ce) | Method |
| [ViewportPointToRay](#member-32f0f9a8c33f1a49) | Method |
| [WorldToScreenPoint](#member-3821a1aea3ddb0c4) | Method |
| [WorldToViewportPoint](#member-a06d3786e7b55b98) | Method |
| [Dpi](#member-31138b9f1b614214) | Property |
| [Height](#member-64f8fbf0f220d607) | Property |
| [State](#member-77f114041a98c04b) | Property |
| [Width](#member-75f22c08bf4539d7) | Property |

<h3 id="member-84cd2f12e87c77fb" class="astra-member">ScreenPointToRay</h3>

```csharp
public Astra.Ray ScreenPointToRay(System.Numerics.Vector2 pixel)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `pixel` | `System.Numerics.Vector2` |  |

<h3 id="member-de4ce83f4fa269ce" class="astra-member">TryGetSafeArea</h3>

```csharp
public bool TryGetSafeArea(out Astra.ScreenRect area)
```

Falso quando a plataforma não informou recortes; então não há área segura a afirmar.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Falso quando a plataforma não informou recortes; então não há área segura a afirmar.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `area` | `Astra.ScreenRect` |  · Out |

<h3 id="member-32f0f9a8c33f1a49" class="astra-member">ViewportPointToRay</h3>

```csharp
public Astra.Ray ViewportPointToRay(System.Numerics.Vector2 viewport)
```

Viewport 0..1, origem no canto inferior esquerdo.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Viewport 0..1, origem no canto inferior esquerdo.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `viewport` | `System.Numerics.Vector2` |  |

<h3 id="member-3821a1aea3ddb0c4" class="astra-member">WorldToScreenPoint</h3>

```csharp
public System.Numerics.Vector3 WorldToScreenPoint(System.Numerics.Vector3 world)
```

x,y em pixels; z = profundidade de vista em metros (negativa atrás da câmera).

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** x,y em pixels; z = profundidade de vista em metros (negativa atrás da câmera).

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `world` | `System.Numerics.Vector3` |  |

<h3 id="member-a06d3786e7b55b98" class="astra-member">WorldToViewportPoint</h3>

```csharp
public System.Numerics.Vector3 WorldToViewportPoint(System.Numerics.Vector3 world)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `world` | `System.Numerics.Vector3` |  |

<h3 id="member-31138b9f1b614214" class="astra-member">Dpi</h3>

```csharp
public float Dpi { get; }
```

DPI informado pelo sistema; zero quando desconhecido.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** DPI informado pelo sistema; zero quando desconhecido.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-64f8fbf0f220d607" class="astra-member">Height</h3>

```csharp
public float Height { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-77f114041a98c04b" class="astra-member">State</h3>

```csharp
public Astra.GameViewState State { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-75f22c08bf4539d7" class="astra-member">Width</h3>

```csharp
public float Width { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Câmera e navegação](/pt-br/snapshot-2026-10-06/roadmap/camera-e-navegacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.