> For the complete documentation index, see [llms.txt](https://sentido.gitbook.io/sentido_docspage/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sentido.gitbook.io/sentido_docspage/guias/app-sentido/publish-your-docs/codigo.md).

# Código

Esta secção detalha o funcionamento do ecrã de Acesso ao Código, que é o ponto de entrada para qualquer experiência no SENTIDO. Este ecrã foi desenhado para ser intuitivo, oferecendo dois métodos de validação, através de um sistema de alternância por abas - acesso através de QR Code e acesso via código alfanumérico.

### <mark style="color:$primary;">Ativação da Câmara e Permissões</mark>

Após o Onboarding, é apresentado o ecrã de acesso através de código. Por defeito, a aplicação prioriza a leitura visual por QR Code, mas é possível também aceder via código digitado.

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="https://206221821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwA3QvyTB9T9Tdd4lChz7%2Fuploads%2FGpMziDQqVjdsUidOY7GD%2FGroup%2039.png?alt=media&amp;token=aa58f11b-283a-40d4-af9e-f0ec3c44e956" alt="Figura 1 - Módulo de Permissão de Câmara. Ecrã de código com um módulo sobreposto que informa que a aplicação precisa de aceder à câmara do dispositivo. Na parte inferior do módulo existem os botões &#x22;Não permitir&#x22; e &#x22;Permitir&#x22;." width="215"><figcaption><p>Fig.1 Permissão de acesso a câmara</p></figcaption></figure>
{% endcolumn %}

{% column width="58.33333333333333%" %}
É pedido que permissão ao acesso à câmara do dispositivo, de forma a que a plataforma consiga ler o QR Code.

<mark style="color:$primary;">**1.1.**</mark> Nesta página, aparece a seguinte notificação de consentimento perante a ativação da câmara;

<mark style="color:$primary;">**1.2.**</mark> Clica no botão <mark style="color:$primary;">**"Permitir"**</mark> para ativar o acesso da câmara fotográfica, para assim conseguires aceder aos eventos através do QR Code.

{% hint style="info" %}
Se não deres consentimento para o uso da câmara fotográfica, não é possível usar o mecanismo de QR Code.

Para ativares posteriormente, tens que redefinir o consentimento nas definições do sistema operativo.&#x20;
{% endhint %}
{% endcolumn %}
{% endcolumns %}

## <mark style="color:$primary;">Como obter Acesso ao Código</mark>

Para garantir que todos os utilizadores consigam usufruir da experiência do SENTIDO, é fundamental compreender como funciona o sistema de acesso aos conteúdos. O código de acesso é a chave para desbloquear transmissões personalizadas, embora a sua obrigatoriedade dependa da natureza do evento.&#x20;

O fornecimento dos códigos é da inteira responsabilidade das organizações e entidades promotoras dos eventos. Podes obter o seu acesso através dos seguintes canais:

{% columns %}
{% column %}

* **Canais Digitais**: O código é enviado diretamente no e-mail de confirmação ou está presente no seu bilhete eletrónico.
* **No Recinto do Evento:** Encontra os códigos disponíveis em locais estratégicos, como a bilheteira física ou balcões de apoio.
* **Apoio Presencial:** Solicita ajuda à equipa de *staff* presente no local para obter o código ou para introduzi-lo na aplicação.
  {% endcolumn %}

{% column %}

<figure><img src="https://206221821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwA3QvyTB9T9Tdd4lChz7%2Fuploads%2FsCnytuq92NcthAQjaBtd%2FPDF.png?alt=media&amp;token=811f8d6c-a70d-4cb4-950a-150ff58548bc" alt="Figura 2 - Código de Acesso. Gráfico com as informações relativas a um evento, como nome, data e hora, e o Código QR e alfanúmerico (com números e letras e em braille) do mesmo."><figcaption><p>Fig.2 Exemplo do <br>Código de Acesso no recinto</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### <mark style="color:$primary;">Regimes de Visibilidade e Acesso</mark>

Embora o código seja o meio comum de entrada, o acesso através deste regime é facultativo em situações excecionais, dependendo da configuração definida pelo organizador. Existem três tipos de eventos na plataforma:

1. **Público:** O evento e a sua transmissão ficam acessíveis automaticamente a todos os utilizadores ao abrir a aplicação, sem necessidade de inserir qualquer código.
2. **Misto:** O evento é exibido na lista pública da aplicação e na agenda, mas o acesso à transmissão propriamente dita está bloqueado, sendo obrigatório o uso do código para visualizar o conteúdo.
3. **Privado:** O evento não é listado nem exibido publicamente na aplicação. Neste caso, o evento e a respetiva transmissão só podem ser acedidos e visualizados através da introdução direta do código específico.

***

## <mark style="color:$primary;">Navegação nas páginas</mark>

O acesso aos conteúdos no SENTIDO é intuitivo e flexível, permitindo validar a entrada através de um sistema que alterna entre a leitura de códigos QR e a inserção manual. Por defeito, o sistema inicia no separador visual, onde a ativação da câmara é acompanhada por sinais de vibração que confirmam a validade do código. Em alternativa, o campo de código digitado está totalmente otimizado por leitores de ecrã, garantindo que o utilizador aceda ao evento com as suas preferências de acessibilidade já ativas.

### <mark style="color:$primary;background-color:purple;">Passo 1: QR Code</mark>

Esta secção detalha o funcionamento do QR Code, que é o método de acesso pré-definido da aplicação. Este sistema foi desenhado para ser a forma mais rápida e autónoma de entrar num evento.

{% columns %}
{% column width="58.333333333333336%" %}
**3.1.** Ao clicares no botão de acesso ao código na página inicial, a aplicação abre automaticamente o acesso de leitura visual (QR Code);

**4.1.** Aponta a câmara do telemóvel para o código QR fornecido pela organização;

* Assim que a leitura é concluída, a aplicação prossegue para a página de evento.

Para garantir a acessibilidade, o sucesso da leitura é acompanhado por um sinal sonoro (leitura do título da página ativa, caso tenha VoiceOver/TalkBack ativo) ou vibração tátil, confirmando a entrada.

Após introdução do código, vais aceder ao evento. \
[Sabe mais aqui.](/sentido_docspage/guias/app-sentido/publish-your-docs/eventos.md)

{% hint style="info" %}
Se não efetuares o consentimento da câmara fotográfica, não vai conseguir usar o mecanismo de QR Code.&#x20;

Para a ativares, tens de redefinir o consentimento nas definições do sistema operativo.&#x20;
{% endhint %}
{% endcolumn %}

{% column width="41.666666666666664%" %}

<div align="left"><figure><img src="https://206221821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwA3QvyTB9T9Tdd4lChz7%2Fuploads%2FdgR7Z8giCLHV1Qh5jxfk%2FFrame%20366.png?alt=media&amp;token=2ff6b519-1f85-446b-b7d1-6c50db58dda5" alt="Figura 3 - Acesso ao código. Ecrã da home com Logo do SENTIDO e abaixo o botão de &#x22;Acesso ao código de acessibilidade&#x22; em destaque. Abaixo secção de eventos e barra de navegação."><figcaption><p>Fig.3. Acesso ao código através da Home</p></figcaption></figure> <figure><img src="https://206221821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwA3QvyTB9T9Tdd4lChz7%2Fuploads%2FtwzCyacwI6zftqElxgV4%2FFrame%20358.png?alt=media&amp;token=adcdd27a-92d2-46d1-93f6-157ef64917b4" alt="Figura 4 - Código QR. Ecrã de Código, com botão que permite alternar entre QR code e código alfanumérico, com a primeira opção selecionada. Abaixo, em destaque, mostra a frase &#x22;Aponte o QR code&#x22; e visor da câmara que mostra um QR code."><figcaption><p>Fig.4. Qr Code</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

### <mark style="color:$primary;background-color:purple;">Passo 2: Código Digitado</mark>

{% columns %}
{% column width="66.66666666666666%" %}
Se preferires digitar o código, segue estes passos para acederes ao teu evento através da introdução manual:

**5.1.** No ecrã de acesso ao código de acessibilidade (onde a câmara abre por defeito), localiza a barra de abas no topo do ecrã e clica na opção <mark style="color:$primary;">**"Código"**</mark>;

**5.2.** Toca no campo de texto centralizado no ecrã;

**5.3.** O teclado do seu dispositivo abre automaticamente, permitindo a introdução do código fornecido pela organização;

**5.4.** O sistema exibirá brevemente o estado <mark style="color:$primary;">**"A validar..."**</mark> após digitares o código. Se este estiver correto, és automaticamente encaminhado para a página do evento. Mas, se no lugar de "A validar...", aparecer <mark style="color:$primary;">**"Erro"**</mark>, significa que este código está errado e terá de digitar o código correto.&#x20;

Após introdução do código irás aceder ao evento. \
[Sabe mais aqui.](/sentido_docspage/guias/app-sentido/publish-your-docs/eventos.md)
{% endcolumn %}

{% column width="33.33333333333334%" %}

<figure><img src="https://206221821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwA3QvyTB9T9Tdd4lChz7%2Fuploads%2Fcu36YACxi7OQ42yqi9kY%2FFrame%20362.png?alt=media&amp;token=62647bfb-5b9a-445c-ad88-8ca71f2813fc" alt="Figura 5 - Código Alfanumérico. Ecrã de Código, com botão que permite alternar entre QR code e código alfanumérico, com a segunda opção selecionada. Abaixo mostra a frase &#x22;Insira o seu código de acesso&#x22;, um campo de texto, e o indicativo de que a aplicação está a detetar o código. No canto inferior, o teclado está aberto." width="214"><figcaption><p>Fig.5. Código Alfanumérico </p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### <mark style="color:$primary;">ToolTip do Código</mark>

{% columns %}
{% column width="58.333333333333336%" %}
Aqui é detalhado o suporte contextual fornecido pela Tooltip de Ajuda, um recurso essencial para garantir que nenhum utilizador se sinta perdido ou frustrado ao tentar aceder ao evento.

**6.1.** No ecrã de acesso, irá encontrar um ícone informativo, representado por um <mark style="color:$primary;">**"i"**</mark> dentro de um círculo.

**6.2.** Ao ativar, surge um pequeno balão que comunica com o seguinte texto explicativo:

> "Este código foi enviado para o seu e-mail após a compra do bilhete, e encontra-se também em pontos estratégicos no local do evento."

* Fecho: A tooltip é inteligente. Pode fechá-la clicando fora dela, ou voltando a tocar no ícone, permitindo voltar rapidamente à tarefa de inserção do código.
  {% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://206221821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwA3QvyTB9T9Tdd4lChz7%2Fuploads%2FHmPXm0eIDsVno5wmsuba%2FFrame%20365.png?alt=media&amp;token=0d7c01aa-2195-4b90-bc67-c273ccdec08c" alt="Figura 6 - Tooltip do código. Ecrã de código com um módulo de informação aberto no canto superior direito. O texto lê &#x22;Este código foi enviado para o seu e-mail após a compra do bilhete e encontra-se também em pontos estratégicos no local do evento&#x22;."><figcaption><p>Fig.6. Tooltip do Código</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}