Mobile, Payload e Cloud resolvem problemas diferentes
O Mobile SDK suporta aplicações que acessam funções de aeronaves e câmeras compatíveis a partir de ambientes móveis compatíveis. O Payload SDK trata da integração de cargas úteis; a Cloud API trata da integração em nuvem para os produtos enterprise suportados. São camadas de integração diferentes. Decida se você precisa de uma interface de captura no lado do controle, de uma carga útil personalizada ou de um serviço operacional em nuvem antes de escolher uma delas. Não se pode presumir que um recurso do aplicativo oficial de uma aeronave de consumo esteja disponível só porque uma capacidade de nome parecido aparece na documentação da Cloud API enterprise. Parta da função necessária e associe-a à interface suportada adequada. Se o requisito for apenas configuração sincronizada e gravação, não acrescente voo autônomo sem motivo. Mantenha o escopo ligado ao plano e documente os requisitos de acesso e de conexão de cada função. Para chamar cálculos e dados de inspeção a partir do seu próprio aplicativo, veja a API e o servidor MCP do guia de Inspeção.
Leia a compatibilidade como uma combinação completa
Compatibilidade é uma combinação de aeronave, controle, versão do SDK e firmware, com sistema operacional, câmera e detalhes de conexão quando relevantes. O material do V5 verificado para este guia inclui suporte ao Mini 4 Pro, o que ilustra por que afirmações genéricas antigas sobre a família Mini não são confiáveis. Constar em uma lista de produtos ainda não comprova suporte a todas as funções de missão ou de câmera. Leia as notas de versão, as informações de suporte por API e os resultados de capacidade em tempo de execução. Guarde a data e os links da documentação junto com a configuração testada, para que outro desenvolvedor consiga reproduzir o resultado. Mantenha suportado, não suportado e não verificado como estados distintos. Execute os mesmos testes delimitados antes e depois de uma atualização do SDK e identifique explicitamente as mudanças de comportamento.
Um teste mínimo de integração para filmagem aérea
Nossa sequência original de validação é conexão e telemetria, configuração da câmera, estado de gravação, comandos de gimbal e só então missões de voo. Separe o envio bem-sucedido de um comando da confirmação de que o estado solicitado realmente ocorreu. Para waypoints, teste referência de altitude, coordenadas, proa, comportamento do gimbal, ações de chegada, interrupção, retomada e perda de conexão. Os recursos de waypoint do fabricante, a execução de missões pelo SDK e um aplicativo que envia comandos de virtual stick são implementações diferentes. Use simulação suportada ou validação em solo antes do voo e conclua o tratamento de falhas antes de acrescentar uma trajetória cinematográfica complexa. Projete o relato de falhas parciais para configurações agrupadas. A gravação pode começar enquanto uma troca de lente ou de enquadramento falha. Aprove uma tomada só depois de confirmar as condições exigidas.
YOUR NEXT STEP
Coloque em prática.
- Não misture afirmações de compatibilidade de V4/V5 nem de Android/iOS.
- Um produto constar na lista de suportados não significa que todas as APIs sejam suportadas.
Fontes e escopo editorial
As explicações e os exercícios são material editorial original. Verifique as condições específicas de cada produto na versão da documentação indicada.
- DJI — Mobile SDK V5 release notes and supported products ↗
- DJI — Mobile-SDK-Android-V5 official repository ↗
- DJI — Cloud API documentation ↗
- DJI — Payload SDK official repository ↗
Data da pesquisa: 21 de outubro de 2026. Verifique a versão vinculada, o hardware compatível e as condições aplicáveis. As evidências incluem texto revisado diretamente e registros de índices de busca oficiais.
Ler a metodologia e as questões em aberto →