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:
chui://record?name=Weekly%20sync: o endereço próprio da aplicação. Abre a aplicação Chui num iPhone, num telemóvel Android, num Mac ou num PC Windows.https://chui.io/record/start?name=Weekly%20sync: um endereço web. Abre a aplicação Android onde estiver instalada. Nos restantes casos, abre o chui.io num separador do navegador, que grava aí. Por agora, os iPhones abrem esta ligação no navegador. Use chui://record para chegar à aplicação do iPhone.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.
<a href="chui://record?name=Design%20review">Record with Chui</a>location.href = 'https://chui.io/record/start?name=' + encodeURIComponent(title)chui://record?name=Standup.open "chui://record?name=Standup"start "" "chui://record?name=Standup"