Interface de Programação de Aplicativos (API)

O que é uma API?

Uma API é um conjunto de regras que permite que componentes de software se comuniquem entre si. Isso pode ser seu próprio código se comunicando com um motor de jogo, um aplicativo se comunicando com um serviço de terceiros ou um dispositivo se comunicando com hardware de VR/AR.

Especificamente no Unity , isso inclui a programação no Unity por meio da API de Scripting, que permite que seu código controle GameObjects e componentes, bem como APIs de terceiros para serviços como análises, anúncios e SDKs de dispositivos VR/AR.

Como funciona uma API ?

Uma API funciona como uma mensageira entre componentes de software. Seu código envia uma solicitação em um formato definido e recebe uma resposta, sem precisar saber como o outro lado foi construído. Isso cria um canal de comunicação estruturado que permite aos desenvolvedores acessar funcionalidades sem precisar entender como elas são implementadas internamente.

Em um ambiente de desenvolvimento em tempo real, isso significa acessar recursos de hardware, recursos do sistema, serviços externos e conjuntos de ferramentas especializadas por meio de métodos e parâmetros documentados, sem precisar escrever essa funcionalidade subjacente.

Como se utiliza uma API ?

As APIs geralmente aparecem em vários níveis no desenvolvimento de software:

• APIs de mecanismo ou plataforma que controlam a funcionalidade principal.
• APIs e SDKs de terceiros que trazem serviços externos.
• APIs específicas de hardware que expõem recursos do dispositivo.
• APIs do lado do servidor ou de backend que funcionam independentemente de qualquer cliente.

A sobreposição dessas camadas é o que permite que um único software seja executado em diversas plataformas, sistemas operacionais, dispositivos e formatos de hardware, sem a necessidade de reescrever a lógica principal para cada um deles.

Como uma API é usada no Unity?

Especificamente no Unity , você trabalhará com APIs em todos esses níveis. A API de Scripting do Unity é a que você mais usará. É assim que seus scripts C# controlam GameObjects, física, renderização e entrada.

Além disso, os SDKs de terceiros trazem suas próprias APIs para serviços como análises, anúncios e compras dentro do aplicativo . O hardware de VR/AR funciona de maneira semelhante. Ele expõe APIs específicas do dispositivo (como OpenVR para headsets SteamVR), e as estruturas de programação VR/AR da Unity abstraem essas APIs para que seu código não precise saber qual headset está conectado.

Existe também uma camada do lado do servidor: As APIs Web próprias da Unity permitem que você chame serviços como autenticação, Cloud Save e Cloud Code diretamente via REST, sem precisar do Unity Editor ou de um SDK de cliente.

Quais são os benefícios de usar APIs?

As APIs tornam o desenvolvimento de software moderno mais rápido e confiável:

• Desenvolvimento mais rápido: reutilize funcionalidades existentes em vez de criá-las do zero, seja um sistema de pagamento, um mapa ou os dados de rastreamento de um headset de realidade virtual.
• Comportamento consistente em todas as plataformas: a mesma chamada de API funciona da mesma maneira, independentemente do hardware ou sistema operacional subjacente, o que permite que um projeto Unity seja direcionado com sucesso para diversas plataformas.
• Manutenção mais fácil: atualizar o que está por trás de uma API não exige que todos os aplicativos que a utilizam sejam alterados, desde que a própria API permaneça estável.

Perguntas frequentes (FAQ)

Uma API é a mesma coisa que um SDK?

Não. Uma API é a própria interface, as regras de como solicitar dados ou funcionalidades. Um SDK é um conjunto de ferramentas mais abrangente que geralmente inclui uma ou mais APIs, além de outras ferramentas como documentação, código de exemplo e um compilador.

Preciso entender de APIs para usar o Unity?

Não para usar as ferramentas integradas do Editor, mas sim, assim que você escrever um script. Todo script que você escreve no Unity chama a API de Scripting, então um conhecimento básico de como as APIs funcionam torna a criação de scripts muito menos misteriosa.

Qual a diferença entre uma API pública e uma API privada?

Uma API pública está disponível para qualquer desenvolvedor usar, geralmente com documentação e um portal para desenvolvedores. Uma API privada (ou interna) é restrita ao uso dentro de uma única empresa ou projeto, e não se destina a desenvolvedores externos.