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 construído aqui estava publicado na época da sonda

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: das 39 linhas até a submissão, 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 até a submissão, observadas à vista de todos

→

o nosso manifesto decisões 37–42, corrigidas aqui primeiro

→

o Marketplace submetido: a rota de instalação que funciona, quando listar

→

outras mãos o estudo de campo, destravado quando listar

e o campo escreve as próximas linhas

Os cinco 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

fricção 41 · a referência do scaffold põe no pacote 12 arquivos do próprio Plugin Service, 9,5 MB de 9,5 MB; pack e verify deram OK; o QA da loja o devolveu → decisão 41 · <Private>false</Private>, build numa pasta vazia, 33,6 KB; tínhamos lido a lista de arquivos na submissão sem compará-la com nada

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

submetido a peça de quebra-cabeça do scaffold, aposentada · decisão 40