> For the complete documentation index, see [llms.txt](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/usage-guide.md).

# Guida all'uso

## Aprire la radio

Premi **F5**, scrivi `/radio` oppure usa l'item `radio`. La finestra mostra la radio portatile. Tutto si fa con mouse e tastiera:

* **Frequenza**: digitala da tastiera (per esempio `101.50`), poi premi **CONNECT**. Sul tastierino `*` è il punto decimale, `#` cancella.
* **Accensione**: il pulsante di accensione accende e spegne la radio. Spegnerla lascia il canale.
* **Parlare**: tieni premuto il tasto di pma-voice (default **Alt sinistro**, "Talk over Radio"). Il PTT funziona con la UI aperta o chiusa.
* **Esc** chiude soltanto la radio.

Altre schede e opzioni: volume, preferiti (slot di memoria), canali lavoro, lista membri, nominativo e impostazioni della radio (lingua, suoni, dimensione, prop). Le impostazioni di ogni giocatore sono salvate per licenza Rockstar, non per personaggio.

## Canali lavoro

La scheda lavoro elenca solo i canali che il giocatore può usare, con un clic per entrare. Se lavoro o grado del giocatore cambiano, viene tolto dal canale e la lista si aggiorna. Per definirli vedi [Integrazioni](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/integrations.md#canali-lavoro-e-grado).

## Lista membri

Mostra chi è sulla frequenza e chi sta parlando. Il nome arriva da `Config.Members.nameSource` e il formato da `Config.Callsign.display`. Il server può inviare i membri solo sui canali lavoro (`Config.Members.showOnPublic = false`).

## Nominativo

I giocatori impostano il nominativo nelle **Impostazioni** della radio (default max 8 caratteri: lettere, cifre e `-`). Il server lo valida e lo salva per giocatore. Se non ne è impostato uno, QBCore/Qbox usano `metadata.callsign`. Gli script possono leggerlo o impostarlo con gli export `getCallsign` / `setCallsign`.

## Segnale

* Barre da 0 a 4 dalla distanza 2D dalla torre più vicina (`Config.Signal.towers`).
* Interni, aree sotterranee e zone morte abbassano il segnale.
* Sotto `staticBelow` barre la radio riproduce statico e mostra un avviso.
* Sotto `minTransmit` barre (con `blockTransmit = true`) **non si può trasmettere**: il PTT viene fermato subito. La ricezione non è mai bloccata.
* Nessuna batteria.

{% hint style="info" %}
Il blocco di trasmissione senza segnale ferma il PTT di pma-voice subito dopo la pressione del tasto, quindi gli altri potrebbero sentire un brevissimo click.
{% endhint %}

## Pulsante di emergenza (SOS)

Premi due volte il pulsante arancione sulla radio. Tutti sulla stessa frequenza ricevono una notifica con nominativo o nome e via, un blip sulla posizione per `blip.seconds` secondi, il suono e (con la radio aperta) il lampeggio della UI. Il server controlla radio accesa, connessione, canale lavoro, cooldown e rate limit. Vedi [Configurazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/configuration.md).

## Animazioni radio

L'animazione parte **mentre trasmetti** e, con `Config.Prop.whileUI`, mentre la finestra è aperta (la radio è tenuta in mano e guardata). I giocatori scelgono l'animazione di conversazione con `/radioanim` (**F4**); l'interruttore del prop è nelle impostazioni.

* Una sola sessione di animazione alla volta: nessun prop duplicato. Il prop viene sempre eliminato (rilascio PTT, morte, veicolo non consentito, stop della risorsa, scarico del personaggio).
* Nessuna animazione da morti, in ragdoll, in caduta, a nuoto o mentre si sale su un veicolo.
* Con un'arma in mano l'animazione di conversazione parte solo se `Config.Anim.withWeapon` o `Config.Anim.whileAiming` è `true`; i preset con la mano destra passano allora al preset `default` (mano sinistra).
* Sparo e corpo a corpo sono bloccati solo mentre trasmetti (`Config.Anim.blockFiring`).

## Regole del push-to-talk

* La radio trasmette sempre, tranne quando il giocatore è **morto** o **ammanettato** (`Config.Death.blockWhenCuffed`, default `true`).
* Con un'arma in mano trasmette comunque: pma-voice 7.0.1 e questa risorsa non lo bloccano.
* Con la UI chiusa il PTT dà comunque un riscontro: click `ptt_on` / `ptt_off` e un piccolo segno TX (`Config.UI.txIndicator`).
* **Cooldown**: una pressione entro `Config.Ptt.cooldown` ms dal rilascio della trasmissione precedente viene rifiutata (nessuna trasmissione, click, segno o animazione). La prima pressione è sempre immediata.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/usage-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
