Integração com terceiros

SDK 2.0.0. A mesma API C++ e o mesmo modelo de integração de Windows · Integração com terceiros: os fornecedores desktop costumam entregar buffers I420 / YUV, não callbacks de textura OpenGL no estilo mobile. Esta página cobre as diferenças exclusivas do Linux. Helpers compartilhados e o encaixe TRTC / Agora / LiveKit ficam na página do Windows — troque headers e caminhos de biblioteca pelo pacote Linux.

Third-party SDK (preprocess callback)
  I420 planes
       ↓
BeautyEffectEngine
  CreateWithI420 → ProcessImage → write back

Diferenças no Linux

Item	Observações
Biblioteca	`libfacebetter.so` + `facebetter/*.h`
Link	Veja Implementar beleza; observe `LD_LIBRARY_PATH` / rpath em runtime
GL	Crie o mecanismo e processe no thread cujo contexto GL é o atual. As texturas de entrada e saída devem pertencer a esse contexto. Quadros de CPU não precisam de um contexto GL do chamador. A config não tem um flag de contexto.
`resource_path`	Precisa apontar para o arquivo `resource.fbd`
Vinculação no Console	Nome do pacote / executável / processo — Assinatura

Crie o mecanismo:

EngineConfig cfg;
cfg.app_id = "your_app_id";
cfg.app_key = "your_app_key";
cfg.resource_path = "/opt/yourapp/resource/resource.fbd";
auto engine = BeautyEffectEngine::Create(cfg);

Helper I420 compartilhado e hooks de fornecedor: cópia completa em Windows · Integração com terceiros (ProcessI420InPlace, TRTC Buffer, Agora IVideoFrameObserver, fonte de vídeo personalizada LiveKit).

Snapshot dos fornecedores

Fornecedor	Notas Linux
TRTC	PC é somente Buffer / I420 — não use o caminho Texture do Android
Agora	C++ `registerVideoFrameObserver`, ReadWrite + I420 in-place
LiveKit	Fonte de vídeo personalizada; confirme captura + caminho GL/software para hosts headless

Solução de problemas

Sintoma	Verifique
`.so` ausente	`LD_LIBRARY_PATH`, rpath, arquitetura correspondente
`Create` falha	Caminho `.fbd`, autenticação, GL headless / OSMesa
Todo o resto	Igual à solução de problemas do Windows

Relacionado

Windows · Integração com terceiros (principal)
Implementar beleza
Práticas recomendadas
Referência da API

Introdução

Android

iOS

macOS

Windows

Linux

Web

Diferenças no Linux

Snapshot dos fornecedores

Solução de problemas

Relacionado

​Diferenças no Linux

​Snapshot dos fornecedores

​Solução de problemas

​Relacionado

Diferenças no Linux

Snapshot dos fornecedores

Solução de problemas

Relacionado