---
title: "Astra.RandomStream"
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-randomstream/
---

# Astra.RandomStream

Deterministic, per-owner random stream. State is explicitly capturable for replay/save. PCG-XSH-RR 32; Godot 4.5 RandomNumberGenerator is the capability reference. Algorithm/version belongs to Astra and is not sequence-compatible with Godot or Unity.

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

:::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
class Astra.RandomStream
```

Deterministic, per-owner random stream. State is explicitly capturable for replay/save. PCG-XSH-RR 32; Godot 4.5 RandomNumberGenerator is the capability reference. Algorithm/version belongs to Astra and is not sequence-compatible with Godot or Unity.

## Onde acessar este tipo

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): 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 |
|---|---|
| [AlgorithmVersion](#member-de04a41c77e88a4f) | Field |
| [.ctor](#member-2ad2517ba4e94a54) | Method |
| [Capture](#member-511ad835fc7e3d3e) | Method |
| [Gaussian](#member-fd094caa4fc3b157) | Method |
| [InsideUnitCircle](#member-1ded7820dcc953f4) | Method |
| [InsideUnitSphere](#member-d5dd4d8bff658464) | Method |
| [NextUInt](#member-e90e46273ad4d428) | Method |
| [OnUnitSphere](#member-4f4b135cf72e14e5) | Method |
| [Range](#member-09d390b5118a33cd) | Method |
| [Range](#member-461f46493bff97fe) | Method |
| [Restore](#member-36a80a94d87bb21a) | Method |
| [Shuffle](#member-4254ee5a07041f3a) | Method |
| [Value](#member-947e53959b3d6d3d) | Property |

<h3 id="member-de04a41c77e88a4f" class="astra-member">AlgorithmVersion</h3>

```csharp
public const uint AlgorithmVersion = 1
```

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

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ad2517ba4e94a54" class="astra-member">.ctor</h3>

```csharp
public RandomStream(ulong seed, ulong stream = 0)
```

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

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `seed` | `ulong` |  |
| `stream` | `ulong` |  · Opcional: `0` |

<h3 id="member-511ad835fc7e3d3e" class="astra-member">Capture</h3>

```csharp
public Astra.RandomStream.Snapshot Capture()
```

**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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fd094caa4fc3b157" class="astra-member">Gaussian</h3>

```csharp
public float Gaussian(float mean = 0, float standardDeviation = 1)
```

Normal distribution using Box-Muller; zero deviation returns the mean.

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

**Uso:** Normal distribution using Box-Muller; zero deviation returns the mean.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `mean` | `float` |  · Opcional: `0` |
| `standardDeviation` | `float` |  · Opcional: `1` |

<h3 id="member-1ded7820dcc953f4" class="astra-member">InsideUnitCircle</h3>

```csharp
public System.Numerics.Vector2 InsideUnitCircle()
```

**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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d5dd4d8bff658464" class="astra-member">InsideUnitSphere</h3>

```csharp
public System.Numerics.Vector3 InsideUnitSphere()
```

Uniform volume distribution, not a uniform radius.

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

**Uso:** Uniform volume distribution, not a uniform radius.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e90e46273ad4d428" class="astra-member">NextUInt</h3>

```csharp
public uint NextUInt()
```

**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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f4b135cf72e14e5" class="astra-member">OnUnitSphere</h3>

```csharp
public System.Numerics.Vector3 OnUnitSphere()
```

Uniform direction on the unit sphere (no rejection loop).

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

**Uso:** Uniform direction on the unit sphere (no rejection loop).

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-09d390b5118a33cd" class="astra-member">Range</h3>

```csharp
public int Range(int minimumInclusive, int maximumExclusive)
```

Uniform integer range [minimumInclusive, maximumExclusive), without modulo bias.

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

**Uso:** Uniform integer range [minimumInclusive, maximumExclusive), without modulo bias.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `minimumInclusive` | `int` |  |
| `maximumExclusive` | `int` |  |

<h3 id="member-461f46493bff97fe" class="astra-member">Range</h3>

```csharp
public float Range(float minimumInclusive, float maximumExclusive)
```

Finite float range [minimumInclusive, maximumExclusive). Equal endpoints return the endpoint.

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

**Uso:** Finite float range [minimumInclusive, maximumExclusive). Equal endpoints return the endpoint.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `minimumInclusive` | `float` |  |
| `maximumExclusive` | `float` |  |

<h3 id="member-36a80a94d87bb21a" class="astra-member">Restore</h3>

```csharp
public void Restore(Astra.RandomStream.Snapshot snapshot)
```

**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:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `snapshot` | `Astra.RandomStream.Snapshot` |  |

<h3 id="member-4254ee5a07041f3a" class="astra-member">Shuffle</h3>

```csharp
public void Shuffle<T>(System.Span<T> values)
```

Fisher-Yates shuffle, unbiased bounded indices.

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

**Uso:** Fisher-Yates shuffle, unbiased bounded indices.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `values` | `System.Span&lt;T&gt;` |  |

<h3 id="member-947e53959b3d6d3d" class="astra-member">Value</h3>

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

Uniform [0,1), using 24 random bits exactly representable by float.

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

**Uso:** Uniform [0,1), using 24 random bits exactly representable by float.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.