Tacit — Um Vocabulário Háptico para Estado ao Longo do Tempo

_VISÃO GERAL

Matar a premissa primeiro

Antes de duas semanas de design, duas horas para descobrir se a ideia era sequer possível.

Tudo se apoia numa premissa: um plugin precisa alcançar a mão enquanto o usuário trabalha em outro lugar. Se a entrega háptica fosse restrita ao aplicativo hospedeiro — como notificações, foco e teclas de mídia costumam ser —, nenhum vocabulário para tarefas em segundo plano poderia existir. Então o primeiro build não foi o plugin. Foi uma sonda desenhada para matar o projeto a baixo custo.

Fig. 02 — o ecossistema, cada aresta observada, nenhuma inferida

Onde estava a atenção do usuário · cinco aplicativos, nenhum deles o hospedeiro

WindowsTerminal claude Figma chrome explorer

● dois deles trazem o próprio perfil Logi, e os eventos dispararam mesmo assim

Atenção acima · sensação abaixo

O ecossistema do plugin, como o SDK o descreve — e o desenvolvedor está dentro dele

Desenvolvedor externo o ator, não a plateia

Marketplace nunca percorrido

nada aqui está publicado ainda

registra uma fonte de eventos, HasHapticMapping declarado

Logi Plugin Service carrega aquilo para onde é apontado

um arquivo em que qualquer coisa pode escrever

Tacit DefaultEventSource.yaml · eventMapping.yaml

Três escritores uma linha de texto cada

MX Master 4 um atuador

o polegar

a mesma pessoa, nas duas faixas ao mesmo tempo um arquivo .link — escrito num diretório que ainda não existia · fricção 09 um nome semântico resolve para uma das quinze waveforms

A entrega não tem escopo o pulso chega qualquer que seja o dono da tela — e um perfil de terceiro ativo não o suprime 14 ms · seis execuções · 31 eventos

Percorrendo a jornada do desenvolvedor

A espinha dorsal do case: o plugin existe para que estas observações pudessem existir. Cada tropeço foi registrado em bruto, em ordem, nunca editado — e o log assume os nossos próprios erros na mesma tabela.

Fig. 03.1 — a jornada, desenhada como um service blueprint o que chega ao usuário fica uma linha acima do que a plataforma carrega

Instalar Configurar Iniciar Enquanto roda Precisa de você Termina Evidênciao que de fato chega ao usuário um card que não nomeia nada sobre o que reporta um único liga/desliga, dentro da preferência de intensidade um pulsosharp_state_change uma batida, a cada 15 ssubtle_collision uma batida na porta, fora do compassoknock um pulso, ou três a 450 mscompleted / angry_alert Usuárioo que a pessoa faz instala o plugin procura as configurações dele inicia uma tarefa longa troca de aplicativo, e trabalha volta para responder lê o desfecho no polegar Linha de interação Palcoo que o usuário poderia ver ou sentir acontecendo gerenciador de plugins do Options+o Tacit aparece, e não diz nada diálogo Plugin Settings — metadados do manifesto, e o idioma em que o diálogo está escrito o atuador dispara o atuador dispara na batida o atuador dispara fora da batida o atuador dispara Linha de visibilidade Bastidoreso que roda onde o usuário não vê o Logi Plugin Service carrega o plugin a partir de um arquivo .link armazenamento de configurações, criptografado e com chave, sem superfície um escritor acrescenta uma linha ao canalRaiseEvent(taskStarted) o heartbeat, sequenciado no TaskRunnerRaiseEvent(taskTick) o único estado autorizado a interromperRaiseEvent(taskNeedsInput) a figura de três pulsos é sequenciada em códigoRaiseEvent(taskCompleted | taskFailed) Linha de interação interna Suportea plataforma por baixo, e o que ela carrega ou não LogiPluginTool · PluginApi.dllMarketplace, nunca percorrido API de configurações do plugin — ActionEditor, alcançável apenas a partir de uma ação vinculada DefaultEventSource.yamlcinco nomes semânticos — nossos, não da plataforma HasHapticMappingdeclarado no LoupedeckPackage.yaml eventMapping.yamlum nome semântico para uma primitiva quinze primitivas entregues, nenhuma delas pode ser criada

E abaixo das três linhas, o ator de quem a plataforma depende — os cinco achados, na ordem da jornada:

O desenvolvedorum terceiro, fora da empresa, trabalhando apenas com o que é publicado

1O modelo de configuração presume que um plugin é um conjunto de coisas que se apertampara o usuário, isso aparece como um controle que não está lá 2A documentação silencia exatamente onde uma decisão depende deladecide se o plugin chega a ser tentado 3A ferramenta reporta um estado que não é verdadeirodecide se o desenvolvedor confia no que construiu 4O primeiro build do primeiro projeto não compiladecide se existe um plugin, para começo de conversa 5Quinze primitivas, e nenhuma forma de saber como qualquer uma delas é sentidapara o usuário, isso aparece como o padrão errado para o estado

O método é um log de fricção com três disciplinas. As linhas são acrescentadas no momento do tropeço, não reconstruídas depois. Uma coluna quem separa dois perfis de fricção — o do designer e o da IA, porque eles tropeçam de formas diferentes e a diferença é um dado. E uma coluna veredito marca a nossa própria inexperiência como nossa: de 39 linhas, 33 são lacunas de documentação ou plataforma, 5 são lacuna nossa, 1 fica indefinida.

Desenhando o vocabulário

O instrumento com que aquela caminhada foi feita, desenhado à vista de todos. Literatura antes do design: o vocabulário codifica pelo tempo, nunca pela textura — e a razão é um ranking, não uma questão de gosto.

As decisões carregam suas razões. O silêncio é barato e perigoso — uma execução que termina em silêncio e uma que morreu são idênticas, e é por isso que completed existe como sinal positivo. needsInput viola a cadência de propósito: todo o resto cai na batida, então o único estado que precisa de você cai fora dela. A escalada para um pedido ignorado se contrai até um platô em vez de subir indefinidamente — um canal ambiente que cresce até virar alarme mudou de categoria.

E um número foi encontrado na mão: o intervalo da figura é de 450 ms, não os 220 ms com que começou. A 220, o segundo e o terceiro pulsos de uma figura nunca chegavam ao atuador — o piso mecânico fica uma ordem de grandeza acima do piso perceptual de 10 ms que a literatura oferece. Nada na documentação do SDK menciona isso.

A arquitetura tem três camadas, deliberadamente: nomes semânticos no código, o mapeamento nome→waveform na configuração — de modo que revisá-lo depois de um teste com usuários é uma edição, não um rebuild — e as quinze primitivas entregues por baixo. Uma ponte de design tokens, aplicada a um sentido que as ferramentas de design ainda não conseguem pré-visualizar. As duas camadas que entregamos são pequenas o bastante para serem lidas por inteiro:

events:
  - name: taskStarted
    # dispara uma vez, e estabelece do que trata cada pulso seguinte
  - name: taskTick
    # a batida, não uma mensagem — a ausência dela é que carrega sentido
  - name: taskNeedsInput
    # o único estado autorizado a interromper
  - name: taskCompleted
    # terminou, e deu certo
  - name: taskFailed
    # terminou, e não deu certo

haptics:
  taskStarted:    { DEFAULT: sharp_state_change }
  taskTick:       { DEFAULT: subtle_collision }
  taskNeedsInput: { DEFAULT: knock }
  taskCompleted:  { DEFAULT: completed }
  taskFailed:     { DEFAULT: angry_alert }

  # completed e mad nunca são o par — eles foram
  # reportados como os dois padrões mais próximos no dispositivo,
  # e são os dois estados que jamais podem ser confundidos.

Testar um sinal ambiente

Um sinal ambiente não pode testar a si mesmo: o autor já sabe qual estado escreveu no canal, e discriminação não é detecção. O aparato precisa remover esse saber.

O aparato cego escreve um estado terminal aleatório — completed ou failed — e só registra qual foi depois que o palpite é dito. Vinte tentativas em três rodadas, incluindo no ajuste de intensidade Subtle, aquele que um usuário em fluxo de fato manteria: 20 de 20. E uma vez, sem combinar, o vocabulário simplesmente foi usado por uma tarde de trabalho real — o que não é um resultado, mas é a razão pela qual o trabalho pareceu pronto.

Publicar — os achados se voltam para nós mesmos

A publicação não foi um epílogo. Preparar o plugin para o Logi Marketplace virou as observações de campo contra o nosso próprio manifesto — e corrigiu ali o que o log havia reportado em todo o resto.

Fig. 06.1 — o laço que se fecha sobre nós mesmos fricção observada → decisão tomada, no nosso próprio plugin

o log 39 linhas, observadas à vista de todos

→

o nosso manifesto decisões 37–40 — corrigidas aqui primeiro

→

o Marketplace submetido — a rota de instalação que funciona

→

outras mãos o estudo de campo, destravado

e o campo escreve as próximas linhas

Os quatro fechamentos, um a um

fricção 25 · o build só funcionava a partir de uma pasta → decisão 37 · intermediários fixados — a armadilha do próprio scaffold, resolvida pela correção que o log propôs

fricção 27 · o scaffold declara dispositivos que excluem justamente o dispositivo de que o haptics precisa → decisão 38 · o manifesto declara ActionsRing — corrigido no dia em que ganhou uma consequência visível

fricção 39 · o vocabulário de dispositivos aceito só existe dentro da DLL → encontrado por reflection no preparo da submissão — um nome desconhecido é lido como None, em silêncio

a alegação de macOS · empacotada, nunca executada → decisão 39 · a v1 declara apenas Windows — retirada sem teste em vez de submetida sem teste

Fig. 06.2 — a última mudança antes da submissão uma página de loja também é uma superfície

V1 · a barra é o ritmo cortada — agora uma linha do registro

V2 · pulso atravessando a haste cortada — agora uma linha do registro

V3 · a contagem sob a marca a escolhida — um T sobre três pontos

publicado a peça de quebra-cabeça do scaffold, aposentada — decisão 40