Uma ligação que inicia uma gravação

Para programadores: uma ligação abre o Chui e começa a gravar, com nome opcional.

A ligação. Há duas formas de a escrever, e ambas fazem o mesmo:

Ao abrir qualquer uma delas, o Chui passa para primeiro plano no ecrã de gravação, com a gravação já em curso: o relógio a contar e a marca vermelha de gravação visível. Pode colocá-la por trás de um botão na sua aplicação, num convite de calendário, numa página web ou num Atalho.

O nome. O name é opcional. Quando é indicado, passa a ser o nome da reunião, exatamente como se a pessoa o tivesse escrito, e o resumo do próprio Chui não o substitui. Escreva-o codificado para URL (%20 para um espaço). O Chui mantém-no numa só linha de texto visível: remove as quebras de linha e os caracteres invisíveis e corta-o aos 80 caracteres. Sem nome, o Chui dá nome à reunião a partir do que foi dito, como faz sempre. Mais nada na ligação é lido.

Uma gravação já em curso nunca é interrompida. Se o Chui já estiver a gravar, a ligação traz para primeiro plano o ecrã dessa gravação e não altera nada. Não começa uma segunda gravação, nada para e a reunião em curso mantém o seu nome.

Para quem grava. A gravação fica na conta com sessão iniciada nesse dispositivo, tal como uma gravação iniciada com o botão «Gravar». Sem sessão iniciada, o Chui mostra primeiro o ecrã de início de sessão e guarda a ligação: quando a pessoa iniciar sessão nesse dispositivo, no prazo de quinze minutos, a gravação começa com o nome que a ligação trazia. No plano gratuito, aplica-se o limite mensal habitual.

O que a pessoa vê e o que é perguntado primeiro. A ligação nunca consegue gravar às escondidas. O Chui passa sempre para primeiro plano a mostrar a gravação, que a pessoa pode parar ou descartar de imediato. Uma página web também não consegue abrir chui:// sem aviso: o Safari, o Chrome, o Edge e o Firefox perguntam primeiro «Abrir o Chui?». Num separador do navegador, o navegador pede acesso ao microfone da primeira vez e mostra no separador a sua própria marca de gravação. A primeira gravação num telemóvel ou computador continua a pedir acesso ao microfone, como acontece com todas as gravações.

Num separador do navegador, a gravação só dura enquanto o separador estiver aberto e o ecrã ligado. Um separador não consegue ver outro separador. Se abrir a ligação web num novo separador enquanto outro separador do chui.io já está a gravar, começa aí uma segunda gravação, e ambas são guardadas. Para uma reunião numa sala, a aplicação do telemóvel grava melhor.

Exemplos.