RC Surface v2.1.0

RC Surface

Q: Dá para mapear pelo celular?

Sim. MAP, escolha um controle e use Bind ou Trigger Note.

Extensão para o Ableton Live 12 que serve uma superfície de controle no navegador de um celular ou tablet: pads, knobs, faders, XY pads, mixer, transporte e gravação de tracks. Cada controle pode mover um parâmetro do Live, tocar uma nota MIDI ou lançar um clip da Session. Os sensores de movimento, o microfone e a câmera do celular podem ser mapeados do mesmo jeito.

Live 12.4.5+ Suite (Beta) · Safari no iOS 15.4+ ou Chromium no Android, usado na horizontal · mesma rede local · nada é instalado no celular.

PERF: Página de performance: pads, XY e moduladores LFO/Square.
MIX: Página do mixer: oito knobs e oito faders.
SNP: Página de snapshots: guarda o estado da superfície e o recupera.
SNS · AUD · VID: Páginas de sensores: movimento do celular, análise do microfone e rastreio da mão pela câmera.
REC: Página de gravação: arma tracks, grava takes e define um intervalo entre dois markers.
MAP: Liga um controle ou um sensor a um de três destinos: Bind (um parâmetro do Live), Trigger Note (uma nota MIDI) ou Launch Clip (um clip da Session).

Baixar a 2.1.0 Código e licença

Novo na 2.1.0

REC: três vistas

A página REC tem três vistas: Record, Arrangement e Clip.

Modo CFG

Toque em CFG no topo e depois toque num pad, knob, fader ou XY para editar as opções dele.

Aba Rede

A aba Rede mostra o endereço que o QR usa; USAR fixa um e ACHAR CONFIGURAÇÃO lista cada um com o próprio QR.

Certificado local

Uma autoridade certificadora deste computador assina o certificado do servidor para localhost e endereços privados da rede.

AUT

Toque em AUT para gravar e repetir gestos nos pads XY.

Gravar e reproduzir ainda não foram verificados no Live no macOS. Lista completa: notas da versão.

Cadeia de sinal

┌─ NODE 0 ─────────────────────────────────┐
│ PHONE BROWSER          TOUCH IMU MIC CAM │◀─┐
│ PERF · MIX · SNP · SNS · AUD · VID · MAP │  │
└────────────────────┬─────────────────────┘  │
     SALTO 1  ▼  HTTPS · AUTOASSINADO · WSS   │
┌─ NODE 1 ─────────────────────────────────┐  │
│ RC SURFACE SERVER                 v2.1.0 │  │
│ SMOOTH · CURVE EVAL · MORPH · SNAPSHOT   │  │
└────────────────────┬─────────────────────┘  │
     SALTO 2  ▼  EXTENSIONS SDK · LOCAL       │
┌─ NODE 2 ─────────────────────────────────┐  │
│ EXTENSIONS SDK          LOCAL HOST API   │  │
│ PARAMETERS · MIXER · TARGET CATALOG      │  │
└────────────────────┬─────────────────────┘  │
     SALTO 3  ▼  LIVE OBJECT MODEL · INTERNO  │
┌─ NODE 3 ─────────────────────────────────┐  │
│ ABLETON LIVE 12.4.5                SUITE ├──┘
│ SESSION · DEVICES · MIXER · TRANSPORT    │
└──────────────────────────────────────────┘
▼ CONTROLE, SAÍDA        ◀ ESTADO, ENTRADA

Fonte de clock

Modo	Precisa de	O que ele oferece
AbletonOSC	AbletonOSC	Preciso no beat: metrônomo, subdivisões, swing, fase.
SDK	nada	Simulador de BPM a partir do andamento do Live. Sem fase de beat.
Free	nada	Clock interno. Não segue o andamento do Live.

O AbletonOSC só é necessário para o Deep Sync e é instalado à parte, como Control Surface, com as portas UDP 11000/11001 livres. Sem ele, todo o resto funciona. Segure SYNC para escolher a fonte de clock, as subdivisões, a fase, o swing e as formas de onda.

Mapa da superfície

PERF MIX SNP SNS AUD VID REC MAP TRN AUT CFG

As figuras de planta são esquemas desenhados para o layout da 2.0.0, não capturas de tela.

Fig. 1 PERF: o layout real Sem escala Proj. planta

N	Região	Qtd	O que é
1	Abas de página	7	PERF, MIX, SNP, SNS, AUD, VID, REC. MAP sobrepõe a página; AUT seleciona loops XY no PERF; CFG configura controles.
2	Grade de pads	12	Quatro por linha, três linhas. O comportamento vem do modo, não do pad.
3	Modo do pad	4	A momentâneo, B hold, C toggle, D burst. Vale para os doze; CFG sobrescreve um pad.
4	XY pads	2	Dois painéis `XY 1` / `XY 2` independentes: Estático ou Física, com atrito, quique, velocidade e rastro. Cada eixo é mapeado separadamente.
5	Toggles T1–T8	8	Onda (Sine, Triangle, Ramp Up, Ramp Down, Square) definida no CFG. Arrastar horizontal ajusta velocidade, vertical profundidade. Square inclui swing e ratchet. Hz em FREE, subdivisões em SYNC.
6	PERF UTIL	6	CAP arma captura; CAP+1–4 salva; 1–4 recupera; OFF para morph, pads, LFOs e Squares e centraliza os XY, sem mexer em MIX, sensores, áudio, visão ou transporte.
7	AUT · loops de movimento XY	2	AUT seleciona XY1/XY2; os botões AUT separados abrem ajustes sem gravar. SYNC captura 1–5 compassos pelo clock atual do Live tocando; FREE captura 1–30 segundos em passos de um segundo. Reproduzir/Parar são explícitos; o toque assume o loop até soltar. Pontos salvos não retomam após reconectar. São dados de controle, não automação nativa do Arrangement.
8	Painel do Live	8	BPM, transporte (PREV/PLAY/NEXT), TRN, MAP, AUT, CFG. AUT é um modo do header no PERF.
9	Bloco de sync	3	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, STAGE trava a superfície na página atual.

Fig. 2 MIX: oito knobs e oito faders Sem escala Proj. planta

N	Região	Qtd	O que é
1	Abas de página	7	PERF, MIX, SNP, SNS, AUD, VID, REC. MAP sobrepõe a página; AUT seleciona loops XY no PERF; CFG configura controles.
2	Knobs	8	`knob-1..8`, quatro colunas por duas linhas. Arrasto vertical relativo.
3	Faders	8	`fader-1..8`, uma linha. O cursor anda exatamente o que o dedo anda.
8	Painel do Live	7	BPM, transporte (PREV/PLAY/NEXT), TRN, MAP, CFG. Sem AUT no MIX.
9	Bloco de sync	3	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, STAGE trava a superfície na página atual.

Fig. 3 SNP: oito estados guardados e vector morph Sem escala Proj. planta

N	Região	Qtd	O que é
1	Abas de página	7	PERF, MIX, SNP, SNS, AUD, VID, REC. MAP sobrepõe a página; AUT seleciona loops XY no PERF; CFG configura controles.
2	Slots de morph	8	Estados inteiros do controlador numa grade quatro por dois; recall ou morph para um slot.
3	Controles de performance	3	`CAPTURAR`, `LIMPAR SLOTS`, transição de 0.1 a 5.0 s ou sincronizada, e Grade/Vetor.
4	Pad de morph vetorial	1	Mistura os slots 1 SE, 2 SD, 3 IE e 4 ID ao mesmo tempo, com peso pela posição do ponto.
8	Painel do Live	6	BPM, transporte (PREV/PLAY/NEXT), TRN, MAP. Sem AUT ou CFG no SNP.
9	Bloco de sync	3	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, STAGE trava a superfície na página atual.

Fig. 4 SNS: eixos de movimento e orientação Sem escala Proj. planta

N	Região	Qtd	O que é
1	Abas de página	7	PERF, MIX, SNP, SNS, AUD, VID, REC. MAP sobrepõe a página; AUT seleciona loops XY no PERF; CFG configura controles.
2	Movimento	6 eixos	`GX GY GZ` taxa angular, `AX AY AZ` aceleração, com sinal em torno do centro.
3	Orientação	3 eixos	Yaw, pitch e roll como ângulos numéricos.
4	Visão local	2	Mostra ou esconde os dois blocos só neste celular; os sensores continuam rodando.
5	Legenda dos eixos	3 eixos	Mostra a que eixo do celular cada nome de canal se refere.
8	Painel do Live	6	BPM, transporte (PREV/PLAY/NEXT), TRN, MAP. Sem AUT ou CFG.
9	Bloco de sync	4	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, CALIBRATE define referência neutra (postura no SNS, nível no AUD, iluminação no VID), STAGE trava a superfície.

Fig. 5 AUD: entrada de áudio e doze descritores Sem escala Proj. planta

N	Região	Qtd	O que é
1	Abas de página	7	PERF, MIX, SNP, SNS, AUD, VID, REC. MAP sobrepõe a página; AUT seleciona loops XY no PERF; CFG configura controles.
2	Entrada de áudio	1	Escolha o padrão do navegador ou uma entrada permitida e habilite a captura. Nunca começa sozinho.
3	Nível de entrada	1	RMS de entrada, normalizado 0..1. Não é loudness percebido.
4	Histórico do sinal	1	Histórico ao vivo de 2.5 s: Amplitude, Ataques, Timbre, Textura, Bandas ou Tudo.
5	Knobs dos detectores	10	SENS, RELEASE, CURVA, GANHO e SUAVE do grupo. Figuras em SYNC, milissegundos em FREE.
6	Janela de análise	1	JANELA x1/x2/x4 troca detalhe espectral por tempo de resposta.
7	Detectores de áudio integrados	12	Doze fontes 0..1 para mapear: sensor.audio.transient, sensor.audio.kick, sensor.audio.snare, sensor.audio.brightness, sensor.audio.centroid, sensor.audio.flux, sensor.audio.flatness, sensor.audio.spread, sensor.audio.rolloff, sensor.audio.low, sensor.audio.mid, sensor.audio.high.
8	Painel do Live	6	BPM, transporte (PREV/PLAY/NEXT), TRN, MAP. Sem AUT ou CFG.
9	Bloco de sync	4	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, CALIBRATE define referência neutra (postura no SNS, nível no AUD, iluminação no VID), STAGE trava a superfície.

Fig. 6 VID: câmera, poses aprendidas, detectores Sem escala Proj. planta

N	Região	Qtd	O que é
1	Abas de página	7	PERF, MIX, SNP, SNS, AUD, VID, REC. MAP sobrepõe a página; AUT seleciona loops XY no PERF; CFG configura controles.
2	Câmera	1	Liga/desliga, confiança, modo de reconhecimento e a prévia ao vivo.
3	Poses aprendidas	3–15	Começa com G1–G3; + ADD POSE amplia até quinze cartões. Capture 3–6 exemplos por pose; X remove o cartão, CLR o mantém. RETAKE/KEEP revisam capturas isoladas ou discordantes sem alterar o reconhecimento.
4	Detectores nativos	4	Aberta, Punho, Pinça e Victory, opcionais e sem treino. A rotação pertence ao Victory.
5	MAP direto / CLUTCH	2	MAP X/Y/Z, PALM e FACE são entradas contínuas de mapeamento. CLUTCH X/Y/Z é relativo e congela ao abrir o pinch.
6	Entradas de palma no MAP	2	PALM e FACE com sinal aparecem em unidades brutas; MAP usa 0–1 normalizado. FACE é orientação palma/dorso, sem rastreamento facial. Amostras ausentes/inválidas seguem Safe loss.
8	Painel do Live	6	BPM, transporte (PREV/PLAY/NEXT), TRN, MAP. Sem AUT ou CFG.
9	Bloco de sync	4	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, CALIBRATE define referência neutra (postura no SNS, nível no AUD, iluminação no VID), STAGE trava a superfície.

Fig. 7REC: Arrangement / CLIPSem escalaProj. planta

Este desenho é o esquema da 2.0.0: duas visões, mostradores redondos de nível e o botão STAGE. A página REC atual tem três visões (Gravar, Arrangement e Clip) sobre uma barra de captura compartilhada, com um fader de volume em cada linha de track. A tabela abaixo descreve cada parte; o Guia de Uso descreve por completo.

ARRANGEMENT CLIP

N	Região	Qtd	O que é
1	Seletor GRAVAR / ARRANGEMENT / CLIP · CLICK	3	Uma barra de modo fixa troca as três visões locais, com Gravar como padrão. A barra de captura (REC / STOP / CLICK) é compartilhada pelas três e fica no mesmo lugar em cada visão. CLICK é compartilhado com TRN: na montagem, no pré-roll, durante o REC e no playback, liga e desliga o metrônomo do Live, seguindo o estado do metrônomo que o Live informou por último.
2	REC / STOP / CLICK · VOLTAR AO ARR	4	STOP tem prioridade na preparação e no pré-roll. REC coloca o Punch In em OFF no início direto e em ON no pré-roll, e restaura o Punch In só quando ele ainda tem o valor que o REC escreveu. VOLTAR AO ARR aparece quando a Session sobrepôs o Arrangement e retorna explicitamente quando todos os clips da Session estão ociosos.
3	PRÉ-ROLL e PASSES / Até STOP	2	OFF começa no marcador. 1/2/4 tocam compassos anteriores com click até Punch In abrir no marcador. Esta preferência do navegador não altera o count-in nativo, somente leitura.
4	Marcadores / compasso.beat / Zoom	1	Os marcadores são preparados no Live e aparecem no catálogo; o celular não cria nenhum. Escolher um marcador é uma seleção local que nunca procura posição no transporte do Live. Zoom e rolagem preservam a escala musical; as duas pontas têm margens.
5	Marcadores START / END	2	Escolha um marcador START; o FIM é o próximo marcador, um marcador explícito ou Até STOP para gravação sem fim definido. O Live confirma a região antes do REC, e o trecho fica congelado enquanto a captura está em andamento.
6	Linhas de track / fader de volume / ARM MULTI	4	ARM MULTI acumula entradas. EXCLUSIVE desarma outras somente ao apertar ARM de uma track. REC confirma o conjunto armado visível; STOP mantém as entradas armadas. A linha de um grupo tem o próprio fader, e armá-la arma os descendentes armáveis dentro dele.
7	CLIP / cena da Session	1–16 bars	CLIP substitui a timeline por uma grade de Session paginada, nas mesmas linhas de track compartilhadas. Escolha a cena alvo; LENGTH (1/2/4/8/16 compassos) e QUANTIZE (Global/None/1 bar/1 beat) ajustados no próprio painel. REC mostra fila, gravação ou playback; STOP para apenas as tracks que o REC iniciou, mantém ARM e o transporte global e fica pendente até o Live confirmar a parada. BACK TO ARR retorna explicitamente quando todos os clips da Session estão ociosos, sem Pause/Play. Sem overdub de clip existente nem navegador de takes/comp.
8	Painel do Live	5	BPM, transporte (PREV/PLAY/NEXT), só TRN. Entrar no REC fecha o MAP; sem AUT ou CFG.
9	Bloco de sync	3	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, STAGE trava a superfície na página atual.

Fig. 8 MAP: barra armada, modo de ação e seletor de destino Sem escala Proj. planta

N	Região	Qtd	O que é
1	Página por baixo	1	MAP é sobreposição, não aba. A página de baixo continua visível até escolher um controle.
2	Faixa armada	1	Mostra só `MAP ARMADO / TOQUE UM CONTROLE / PRONTO`, e some quando um controle é tocado.
3	Overlay de edição	1	Um painel de 400 px à direita assume o editor de mapeamento.
4	Modos de ação	3	`BIND` move um parâmetro do Live com curva e faixa; `TRIGGER NOTE` toca uma nota MIDI pelo `RC-Midi-Receiver.amxd`; `LAUNCH CLIP` dispara clips da Session pelo AbletonOSC.
5	Filtro de alvos	1	Busca nomes de destino; `Selecionado no Live` restringe à track e ao device atuais.
6	Hierarquia	3 níveis	Track → Device → Parâmetro, mais os grupos Song/Main/Master e Return.
7	Atalho da seleção do Live	1	Usa a track e o device selecionados no Live como filtro; não escolhe parâmetro por você.
8	Painel do Live	7	BPM, transporte, TRN, overlay MAP ativo, CFG sobre a página atual.
9	Bloco de sync	3	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, STAGE trava a superfície na página atual.

Fig. 9 TRN: overlay Transport Lite Sem escala Proj. planta

N	Região	Qtd	O que é
1	Linha principal de transporte	4	PLAY, STOP, PREV, NEXT com alvos grandes de toque. Espelha o estado de playback nativo do Live.
2	CLICK, Quantização, REFRESH	3	CLICK compartilhado com REC e nunca travado; a Quantização global é lida do Set do Live quando a sobreposição abre e gravada de volta nele; REFRESH ressincroniza o estado do transporte.
3	Localizadores com busca	1	Lista de marcadores do Arrangement com filtro de busca. Tocar em um localizador leva o transporte do Live até ele, e o playback continua.
4	Badge de status e sincronização	1	Badge exibe timing SINCRONIZADO, SDK ou FREE. Linha de aviso aparece apenas sem AbletonOSC, mudança não confirmada ou em modo visualizador.
8	Painel do Live	8	BPM, transporte, overlay TRN ativo, MAP, AUT, CFG.
9	Bloco de sync	3	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, STAGE trava a superfície na página atual.

Fig. 10 AUT: ajustes e captura de loops de gesto XY Sem escala Proj. planta

N	Região	Qtd	O que é
1	Ativação no header	1	AUT é um modo contextual do header disponível apenas no PERF. Tocar em AUT arma a captura de gesto em qualquer um dos pads XY.
2	Captura de gesto e loop	2	Tocar no XY inicia uma contagem regressiva 3–2–1 com pulsos vermelhos; borda vermelha indica gravação ativa; o movimento capturado entra em loop imediatamente ao terminar.
3	Segurar para ajustes	1	Segurar o pad XY por 600 ms sem mover (ou clicar com o botão direito no desktop) abre os ajustes sem gravar.
4	Duração e timing	2	SYNC oferece 1–5 compassos (padrão 2 compassos); FREE oferece 1–30 segundos em passos de 1 s (padrão 10 s). Mudar duração ou modo de timing descarta a gravação daquele XY.
5	Reprodução, takeover e segurança	4	Record/replace, Play, Stop e Clear (com confirmação). Toque manual sobrepõe o loop até soltar; quadradinho branco indica o alvo de takeover. Não escreve automação no Live.
8	Painel do Live	8	BPM, transporte, TRN, MAP, modo AUT ativo, CFG.
9	Bloco de sync	3	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, STAGE trava a superfície na página atual.

Fig. 11 CFG: overlay de configuração por controle Sem escala Proj. planta

N	Região	Qtd	O que é
1	Modo de configuração (CFG)	1	Ajustes por controle: pads, oito slots toggle, Estático/Física nos dois XY. Só PERF e MIX.
2	Overrides de modo dos pads	12	Sobrescreve o modo global A–D em um pad individual: A, B e C ajustam curso do arrasto (Muito curto a Longo) e resposta (Linear/Fine/Fast); nível ao tocar no A; toque sem arrasto mantém ou zera no B; nível ligado no C; timing no D (40–10000 ms ou musical, ataque, pico).
3	Parâmetros de toggles e LFO	8	Escolha a forma de onda (Sine, Triangle, Ramp Up, Ramp Down, Square), modo de timing e subdivisão. Ajustes avançados expõem fase e swing/ratchet para Square.
4	XY Static e Physics	2	Alterne entre Static e Physics para cada pad XY. Parâmetros de Physics: atrito (0.002–0.05), quique (0–0.95), velocidade (0.1–4×). Reset remove o override.
5	Segurar para editar pontos	2	Pontos da curva de resposta do MAP e do envelope Burst só editam após segurar por ~0.6 s: anel indicador aparece, arraste para mover, solte para fixar. Toques rápidos e rolagem nunca movem pontos. Duplo toque reseta.
8	Painel do Live	8	BPM, transporte, TRN, MAP, AUT, modo CFG ativo.
9	Bloco de sync	3	SYNC alterna SYNC/FREE (segurar para Deep Sync Settings, Fonte de clock), ⚙ ajustes, STAGE trava a superfície na página atual.

O que cada família faz, do toque ao Live, está em Controles.

.surface-tabs{display:none} .surface-deck{display:block} .surface-sheet{visibility:visible;opacity:1;pointer-events:auto} .surface-sheet + .surface-sheet{margin-top:30px}

Controles

01Performance 02Controles contínuos 03Snapshots 04Movimento e áudio 05Visão 06Mapeamento e MIDI

Pads, LFOs, squares

A volta a zero, B mantém o que você deixa, C trava, D dispara um burst, ajustável por pad no CFG. Cada um dos oito slots LFO pode usar Square; escolha seu clock no CFG ou siga o ajuste global SYNC/FREE.

VALOR ↑TEMPO →TOQUE = ▼ · SOLTA = △

A · SOLTA

toqueup

o arrasto define o nívelSOLTA → zero na hora

B · SEGURA

GUARDADOMANTÉM

o arrasto edita o nívelSOLTA → segura o valor novo

C · ALTERNA

TOQUE LIGATOQUE DESLIGA

trava em dois toquessegurar + arrastar edita com ele ligado

D · BURST

70 ms de attack450 ms de release

one-shot A–Rarrasto define o pico .15–1 · a duração segue a grade em SYNC

BEAT

1234

SYNC / FREErepete na divisão do beat

XY, knobs, faders

Cada XY escolhe Estático ou Física, com atrito, ricochete e velocidade próprios. Knobs e faders seguem o dedo a partir do valor atual e nunca pulam para o ponto tocado.

1 · ARRASTO VERTICAL RELATIVOKNOB · FADER

O ponto do toque nunca é o valor. O controle parte do valor atual

valor

mesmo
tamanho

dedo

No toque dy é 0, então nada se move. O knob cruza a faixa inteira em 150 px; o fader anda o mesmo que o dedo.

valor = inicial + dy / rangePx KNOB 150 · MACRO KNOB 220 · FADER 150

2 · FÍSICAXY 2

Soltar não faz parar

percorridopara onde ele segueborda do pad · ricocheteia a ×0.75

VELOCIDADE CONFIGURÁVEL v ×= 0.988 a cada frame · para abaixo de 0.01

Snapshots e morph vetorial

CAPTURAR guarda todos os controles mapeados num dos oito slots. Chamar um slot interpola até ele no tempo definido. O Vetor XY mistura os slots 1–4 pela posição do dedo.

GUARDA UM ESTADO · RECALL VOLTA ATÉ ELE NO TEMPO DEFINIDO · MISTURA QUATRO ESTADOS

CAPTURA / RECALL

ESTADO AO VIVO

VOL

CUT

SEND

PAN

CAP

OITO SLOTS

12345678

ATUALSLOT 3

RECALL = interpolação cronometrada · Free 0.1–5.0 s ou Sync em beats

MORPH VETORIAL

SAÍDA MISTURADA

A .12

B .54

C .08

D .26

quatro estados de canto → mistura ponderada

Movimento, orientação, áudio

CALIBRAR faz da postura atual a referência. AUD transforma som em controle: nível, envelope, gate, ataques e doze descritores, no gráfico dos últimos 2.5 segundos.

MOVIMENTO DEFINE UMA REFERÊNCIA · ÁUDIO MAPEIA O SOM PARA VALORES DE CONTROLE

MOVIMENTO

CALIBRAR

AX AY AZ · GX GY GZ

ENTRADA DE ÁUDIOLIVE

RMS0.42

ENV0.38

SINAL / 2.5sLIVE

RMSENV

SENS0.65

subida da bandaarraste ↑↓

RELEASE45 ms

cauda do pulso10–500

WINDOW · 1024 @48kx1x2x4

SYNC segue o BPM do Live de 1/128 a 1/1, com tercinas e pontuadas; FREE guarda os próprios milissegundos. Graves, médios e agudos são loudness ponderado K (ITU-R BS.1770), em LU.

Detectores de áudio integrados

ATTACKS

TRANSIENT0.82

KICK0.64

SNARE0.10

TONE

BRIGHTNESS0.36

CENTROID3000 Hz

ROLLOFF 95%5000 Hz

TEXTURE

FLUX0.25

FLATNESS0.08

SPREAD3000 Hz

BANDS

LOW0.24

MID0.18

HIGH0.09

ciano = RMS instantâneo · verde = envelope suavizado

Visão: mão, poses, clutch

X/Y/Z da mão, tamanho PALM e orientação da palma FACE são mapeáveis continuamente. Pinch mantido engata o clutch; soltar congela os eixos. G1–G15 e os quatro detectores nativos fornecem saídas. Amostras ausentes/inválidas seguem Safe loss.

PINCH CLUTCH: VOCÊ PODE SOLTAR A PINÇA E RETOMAR DO VALOR GUARDADO

1 · ENGATA

as duas pontas se tocamo contato passa de .75o clutch engata

2 · MOVE

a mão percorre o espaçoX, Y e Z acompanhama partir de onde você começou

3 · SOLTA

os dedos se separamo contato cai abaixo de .55o valor fica onde estava

REPITA A PINÇA: O CLUTCH RETOMA DO VALOR GUARDADO

CONTATO = distância entre o landmark 4 e o 8, dividida pelo tamanho da palma ARM em .75 · RELEASE abaixo de .55 · travado entre os dois

sensor.vision.pinch_x · _y · _z relativo, nunca absoluto

ENSINAR UMA POSE: SEQUÊNCIA DE PASSOS

1 · ADD POSE

+ ADD POSE cria slots de gestos customizados até G15 (começa com G1–G3). Cada pose é específica para a mão ativa.

2 · CAPTURAR EXEMPLOS

Pressione CAP 3–6 vezes com a mão parada, variando levemente o ângulo e curvatura dos dedos. TEST desbloqueia a partir do 3º take.

3 · TESTE SILENCIOSO

TEST faz checagem silenciosa ao vivo, exibindo "nearest take N · X% of radius" sem disparar saídas de MIDI ou parâmetros.

4 · EDITAR E REVISAR

DEL LAST remove o último take; CLR limpa todos os takes para retreinar; X remove o cartão. Avisos RETAKE/KEEP são consultivos e não mudam o reconhecimento.

5 · DETECTORES NATIVOS E PRESETS

Detectores integrados Open, Fist, Pinch e Victory são opcionais e não requerem treino; Victory inclui rotação do punho. CONF define limiar Low/Medium/High; presets incluem Precision, Balanced (padrão), Performance e Flexible.

6 · SAFE LOSS E MAPEAMENTO

Ajustes de perda de tracking (VID → ⚙): Hold indefinitely, Hold with timeout (0.1–30 s, padrão 10 s) ou Release on loss. Mapeie poses no MAP como sensor.vision.gesture.N (gate momentâneo 0/1, rearma ao soltar a mão).

Detectores nativos: Open / Fist / Pinch / Victory Pinch Clutch ativa controle relativo em sensor.vision.pinch_x · _y · _z

MAP, MIDI e superfícies de mapeamento

O MAP do celular e a aba Mapeamentos do painel dão a cada controle uma de três ações: bind num parâmetro do Live, trigger de nota MIDI ou disparo de clip da Session, com curva, faixa, takeover e ajustes de repouso.

UM CAMINHO DE SINAL · DOMÍNIO DA FONTE → FORMA 0..1 → DOMÍNIO DO ALVO

FONTE

sensor.audio.centroid

faixa que você define

DOMÍNIO MEDIDO DO SENSOR

TRANSFORMAÇÃOENTRADA → SAÍDA

NORMALIZA

inMin – inMax → 0..1

CLAMP0..1

FAIXA DA FONTE

CURVA DE RESPOSTA

LINEAR · EXPONENCIAL · LOGARÍTMICA · CURVA S

FAIXA DO ALVO

Song Tempo

20–300 BPM

184 BPM

PARÂMETRO DO LIVE ESCALADO

POLÍTICATAKEOVERESCALAPICKUPHOLDPERDA SEGURARELEASESUAVIZAÇÃO

AÇÃO BINDTRIGGER NOTELAUNCH CLIP PARÂMETRO DO LIVE / MIDI / CLIP DA SESSION

SEQUÊNCIA DE MAPEAMENTO EM SEIS PASSOS: DO TOQUE AO LIVE

1 · ESCOLHER ALVO

Abra o MAP, toque no controle e selecione o alvo no seletor Track → Device → Parameter (+ Song/Main/Master e Returns; filtro de busca; "Selected in Live").

2 · NORMALIZAR FONTE

Ajuste a faixa de entrada In min / In max para mapear para 0..1. CLAMP limita valores fora da faixa para evitar saltos.

3 · CURVA DE RESPOSTA

Escolha forma Linear, Exponencial, Logarítmica ou Curva S, com Drive, Comp e Smooth. Segure pontos por ~0.6 s para editar; duplo toque reseta.

4 · FAIXA DO ALVO

Defina Out min e Out max do alvo em unidades nativas do Live. Modos de escala: Auto, Linear ou Geometric para frequência/pitch.

5 · POLÍTICAS

Políticas de takeover / pickup previnem saltos na reconexão; Safe loss define comportamento de Hold vs Release na perda de sinal; timeout ocioso restaura referência.

6 · BIND · TRIGGER NOTE · LAUNCH CLIP

BIND escreve parâmetros do Live via Extensions SDK. TRIGGER NOTE envia notas MIDI pelo RC-Midi-Receiver.amxd inserido manualmente na track MIDI (pitch/oitava/velocity, timing Now/Next Beat/Bar, gate Short/While Held; MIDI do teclado passa direto via thru). LAUNCH CLIP dispara clips da Session pelo AbletonOSC: lança um clip, avança uma lista ou para a track, na quantização informada pelo Live.

.control-tabs{display:none} .control-layout,.control-deck{display:block} .control-sheet{position:static;visibility:visible;opacity:1;pointer-events:auto} .control-sheet + .control-sheet{margin-top:20px}

Situações

Cenário A · dois performers

XY pad -> efeitos de return

Um colega abre o celular e move os efeitos de return enquanto o solista continua tocando.

xy-1.x→distortion Dry/Wetxy-1.y→reverb send

Cenário B · knob e fader

Knob -> Auto Filter cutoff, fader -> reverb return

Um knob abre o Auto Filter e um fader move o return de reverb.

knob-1→Auto Filter cutofffader-1→reverb return

Cenário C · pinch clutch

Pinça -> Auto Filter cutoff

Em pé, sem mesa: faça a pinça com a palma virada para a câmera, mova a mão e abra os dedos.

sensor.vision.pinch_z→Auto Filter cutoff

Cenário D · movimento do instrumento

Taxa de rotação -> feedback do Echo

Um celular preso à guitarra transforma o swell num gesto de taxa de rotação.

sensor.motion.gx→feedback do Echo

Cenário E · entrada acústica

Envelope de áudio -> Saturator Drive

Um celular perto do microfone: o envelope segue o volume das frases.

sensor.audio.envelope→Saturator Drive

Instalação

Vídeo 1 Instalação e primeira conexão, com narração mp4

Instale a extensão

Dê dois cliques no .ablx baixado da versão 2.1.0 para instalar no Live.

Abra o painel

No Live, abra Extensions → RC Surface → Show panel. Ele mostra o QR code, o status da conexão e a URL real se alguma porta estiver ocupada; o elo desenhado em Cadeia de sinal.

Conecte o celular

Escaneie o QR code, instale uma vez a autoridade certificadora deste computador pela página simples na porta HTTPS + 1 e segure o celular na horizontal.

Ative os sensores

Ative Movimento, Áudio ou Visão conforme precisar. A imagem da câmera e o som do microfone nunca saem do celular. Só valores numéricos saem.

Mapeie um controle no Live

Toque em MAP, escolha um controle destacado e ligue-o a um parâmetro do Live ou a uma nota de trigger. As notas precisam do RC-Midi-Receiver.amxd, que vem junto, na track MIDI de destino: o SDK não consegue inserir devices do Max for Live no Live.

Opcional: Deep Sync

Instale o AbletonOSC como Control Surface com UDP 11000 e 11001 livres, e segure SYNC para escolher o clock; veja Fonte de clock.

Solução de problemas

O celular não encontra o computador

Mesmo Wi-Fi. Live liberado no firewall. Escaneie o QR atual de novo, ou abra a aba Rede no painel e clique em ACHAR CONFIGURAÇÃO.

AbletonOSC não detectado

Instale à parte, como Control Surface do Live.

A visão não inicia

Aceite o certificado, libere a câmera, recarregue.

O áudio fica mudo

Libere o microfone e toque de novo no controle de áudio.

Sem menu Extensions no Live

Confira se o host de Extensions do Live 12.4.5+ Suite está habilitado e reinicie o Live.

Perguntas frequentes

Quais versões do Live?

12.4.5+ Suite (Beta).

Android e iOS?

Safari no iOS 15.4+, ou Chromium no Android.

Dá para mapear pelo celular?

Sim. MAP, escolha um controle e use Bind ou Trigger Note.

E a latência?

Os controles são agrupados a 30 Hz; o áudio tem caminho próprio e limitado. Meça ponta a ponta na sua rede.

Câmera e microfone?

Processados dentro do navegador do celular. Nunca são enviados.

Documentos de referência

Guia de instalação

Ler INSTALL.md

Manual do usuário

Ler USER-GUIDE.md

Customização e desenvolvimento

Ler CUSTOMIZATION.md

FAQ

Ler FAQ.md

Modelo de ameaças

Ler SECURITY.md

Política de privacidade

Ler PRIVACY.md

░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░