API de streaming de vídeo: As 8 principais coisas a considerar ao escolher uma API RESTful

Escolher uma API de transmissão de vídeo é uma tarefa importante para os organismos de radiodifusão profissionais. É um dos pontos de decisão mais importantes a tomar e pode ser especialmente assustador para aqueles que pretendem obter o máximo de capacidades de personalização quando se trata de otimizar o jogador no seu plataforma de vídeo em linha.

A API que escolher para integrar no seu leitor de vídeo influenciará o seu resultado final de muitas formas. A sua API estará profundamente integrada em quase todas as linhas do seu código. Consequentemente, as características desta tecnologia subjacente determinam a sua capacidade de personalizar o seu leitor de vídeo. É necessário ter a certeza de que compreende as implicações da API de difusão de vídeo com que optar por trabalhar.

Hoje, vamos analisar o processo de escolha de um streaming de vídeo API para que esteja equipado com os conhecimentos necessários para fazer a melhor escolha. Abordaremos como comparar as funcionalidades da API e como determinar as funcionalidades de que necessita antes de compararmos as API de vídeo incorporadas de várias plataformas de alojamento de vídeo profissional.

Compreenderá o que é uma API de transmissão de vídeo e como utilizá-la.

Vamos a isso.

Índice:

• O que é uma API?
• API do leitor vs. API de transmissão de vídeo
• 8 perguntas a fazer ao escolher uma API de transmissão de vídeo
• API de transmissão de vídeo em fluxo contínuo no Dacast
• Comparação de outros fornecedores de API de transmissão de vídeo
• Conclusão

O que é uma API?

Uma API, ou Interface de Programação de Aplicações, é uma linguagem normalizada que permite personalizar o software. No caso do streaming profissional, a sua API dar-lhe-á o poder de personalizar ainda mais as funcionalidades predefinidas na sua plataforma de vídeo em linha (OVP).

Uma vez que permite que os programas de computador comuniquem entre si, a sua API integra-se no seu código e permite-lhe combinar as funcionalidades do seu OVP com aplicações externas.

As APIs têm algumas formas diferentes. No contexto da radiodifusão profissional, isto inclui a API de vídeo e a API de leitor. As API que utilizar dependerão do que está a tentar realizar.

API do leitor vs. API de transmissão de vídeo em direto

Transmissão em direto e a pedido plataformas de alojamento de vídeo apresentam frequentemente múltiplas API. Normalmente, existem duas categorias gerais: API de transmissão de vídeo e API de leitor.

Para além disso, existem também outras API menos comuns. Por exemplo, algumas plataformas têm APIs separadas para análise, rastreio de utilizadores, manipulação de miniaturas, etc.

Vamos comparar a API de leitor e a API de vídeo para ter uma ideia melhor de como cada uma funciona.

O que é a Player API?

Como o nome sugere, as API de leitor centram-se no próprio leitor de vídeo. Mais concretamente, estas APIs permitem aos utilizadores personalizar o aspeto e as funcionalidades do leitor de vídeo predefinido.

Com a API do leitor, os organismos de radiodifusão podem personalizar os seus leitores de vídeo para:

• Adicionar ou remover botões para partilha, controlos de som, alternância de HD, etc.
• Personalizar o comportamento de reprodução automática
• Mostrar ou ocultar o número de espectadores actuais
• Incorporar o logótipo e a marca
• Alterar o tamanho do leitor para uma largura específica ou um tamanho dinâmico com base num determinado dispositivo
• Inserir anúncios ou intervalos de estações de forma dinâmica numa transmissão em direto (monetização)
• Alternar entre várias transmissões em direto (por exemplo, diferentes ângulos de câmara no mesmo evento) a partir de uma janela do jogador
• Utilize um leitor de vídeo de terceiros

Em suma, uma API de leitor permite-lhe personalizar o seu leitor de vídeo HTML5 ao seu gosto.

O que é a API de transmissão de vídeo em direto?

Uma API de transmissão de vídeo em direto é uma API mais poderosa. Foi concebido para se integrar com o backend de uma plataforma de transmissão em direto. Em geral, esta API permite-lhe manipular as suas transmissões em direto de forma programática.

Algumas das funções que são geralmente acessíveis através de uma API de transmissão de vídeo em direto incluem

• Criar uma nova transmissão em direto
• Iniciar ou parar um fluxo
• Alterar o nome e a descrição do fluxo
• Alterar as definições de privacidade e monetização
• Mudar o nome e manipular as transmissões em direto gravadas

Para concluir, uma API de difusão de vídeo permite-lhe controlar os seus fluxos de vídeo em linha.

Se pretende uma solução de difusão personalizada, precisa de uma API de transmissão de vídeo que lhe permita criar essa solução e que ofereça a possibilidade de alojar os seus vídeos num serviço de alojamento de vídeo profissional.

8 perguntas a fazer ao escolher uma API de transmissão de vídeo

Muitas empresas de radiodifusão profissionais acedem à API de transmissão de vídeo através das suas plataformas de vídeo em linha. Normalmente, as diferentes plataformas vêm com diferentes sistemas de API e documentação.

Ao procurar a melhor API para as suas necessidades de streaming, é provável que compare plataformas de vídeo online com acesso à API e não a própria API. O acesso à API de transmissão de vídeo não é uma funcionalidade normal de transmissão de vídeo, pelo que terá de procurar especificamente plataformas com este tipo de suporte.

Há vários elementos a considerar ao escolher uma API, e todos eles dependem dos seus objectivos únicos de transmissão.

De acordo com Eran Galperin do Binpress existem oito elementos a considerar ao escolher uma API.

Eis oito perguntas a fazer a si próprio para determinar qual a API de vídeo que melhor se adequa às suas necessidades:

1. De que características necessito?
2. Existe documentação completa?
3. Que formatos de dados é que a API utiliza?
4. As convenções de nomenclatura fazem sentido para mim?
5. A API tem limites para os pedidos?
6. Que linguagens de programação são suportadas pela API escolhida?
7. Existe um sistema de apoio e um fórum da comunidade para esta API?
8. A API de transmissão em direto é RESTful?

Descrevemos cada ponto para fornecer mais orientações na sua tentativa de escolher a melhor API de vídeo. Vamos mergulhar.

1. De que características necessito?

A maioria das APIs contém as mesmas características básicas. No entanto, cada plataforma tem o seu próprio “twist”. Consequentemente, determinar qual é a melhor opção para si depende da forma como cada API funciona com os seus objectivos.

Algumas APIs podem fornecer funcionalidades que considera obsoletas. Por outro lado, outra organização pode considerar essa caraterística essencial. A sua perspetiva sobre estas características pode mudar ao longo do tempo, à medida que os seus objectivos e necessidades evoluem.

Faça uma lista das características que são essenciais para as suas necessidades de difusão e faça uma segunda lista das características que seriam ideais mas não são essenciais. Pode avaliar as suas escolhas de API de transmissão de vídeo em direto com base nas suas características desejadas.

2. A documentação é exaustiva?

A utilização de uma nova API é semelhante à aprendizagem de uma nova língua. É difícil adquirir esta competência sem recursos formais. É claro que se pode ir fazendo as coisas à medida que se vai experimentando, mas aprenderá muito mais depressa se se debruçar sobre os livros.

Em termos de API, isto significa que deve procurar a documentação completa do fornecedor. Estas devem explicar o que são as chamadas e dar exemplos de utilização.

Idealmente, a documentação deve também proporcionar um ambiente de teste em “caixa de areia”. Isto permite-lhe testar os comandos sem receio de estragar tudo. Pretende uma API de transmissão de vídeo que ofereça documentação que possa utilizar para criar uma solução personalizada sem grandes complicações.

3. Que formatos de dados é que a API utiliza?

No passado, os formatos Extensible Markup Language (XML) eram normalmente utilizados para APIs. Atualmente, o formato preferido é o JavaScript Object Notation (JSON). Este formato é mais leve em termos de recursos, mais simples de ler e mais fácil de escrever.

Em termos simples, o JSON é uma alternativa melhor. No entanto, algumas APIs devolvem dados noutros formatos, por exemplo, sob a forma de cadeias de caracteres codificadas por URL.

Antes de escolher uma plataforma, verifique os formatos de dados que esta utiliza. Estes integrar-se-ão bem na sua plataforma de alojamento de vídeo existente? Os seus programadores estão à vontade com estas escolhas? São simples?

Se não, talvez seja melhor continuar a procurar. Caso contrário, pode acabar por perder mais tempo do que o desejado a interpretar resultados e a analisar código. JSON é o melhor formato de dados de API de streaming.

4. As convenções de nomenclatura fazem sentido para mim?

É importante notar que cada API utiliza uma convenção de nomes diferente para descrever e interagir com partes distintas do sistema.

Antes de investir numa API, verifique os nomes dos parâmetros e métodos que utiliza. Fazem sentido? Combinam com o seu sentido de estilo na codificação? Se assim for, simplificará o processo de escrita e interpretação de código.

As convenções de nomenclatura podem ser um obstáculo se não fizerem sentido para si. Por exemplo, algumas APIs de streaming de vídeo utilizam nomenclaturas complexas que são altamente técnicas. Tente escolher um que seja menos complexo e mais fácil de utilizar.

Tal como proposto por Marcos Galperin, as convenções de nomenclatura podem ser um obstáculo se não fizerem sentido para si.

Diz ele:

“Atualmente, alguns fornecedores de API tentam ser inteligentes e exigem a utilização de cabeçalhos personalizados e verbos HTTP que não são triviais para programar. Isso pode ser o ideal para si, ou pode ser uma chatice, dependendo do seu ponto de vista.”

5. A API tem limites para os pedidos?

Uma preocupação com as API, especialmente as API viradas para o público, são os ataques de negação de serviço (DDOS) ou o envio de spam para o sistema. Por várias razões, um grande número de pedidos pode sobrecarregar os servidores e tornar as coisas mais lentas para os outros utilizadores. Isto pode ser intencional ou simplesmente o resultado de um código incorreto.

Para evitar uma utilização excessiva, muitas APIs utilizam um sistema de limiares. Isto limita o número de pedidos por chave de API ou endereço IP por dia.

Estes limites fazem sentido do ponto de vista do prestador de serviços. No entanto, enquanto cliente, não quer ser surpreendido por limites como este. Dedique algum tempo a investigar se existem limites de API numa determinada plataforma. Em caso afirmativo, a sua aplicação caberá por baixo dessa altura? Se não, é possível obter uma exceção?

Tenha estas questões em mente ao selecionar uma plataforma para ajudar a evitar problemas futuros.

6. Que linguagens de programação são suportadas pela API escolhida?

As APIs são agnósticas no que diz respeito às linguagens de programação, mas isso não significa que a linguagem seja irrelevante. Muitas APIs incluem SDKs móveis e exemplos de código que são escritos em e para línguas específicas. Ao utilizar estas mesmas línguas, pode poupar muito tempo.

Além disso, pode evitar erros reciclando algum desse código de amostra para utilização na produção. Isto poupa dinheiro, acelera o desenvolvimento e resulta num produto melhor no final.

7. A API dispõe de um sistema de apoio específico ou de um fórum da comunidade?

O apoio técnico é essencial quando se trabalha com qualquer tipo de software complexo. Preste atenção ao suporte e aos recursos que estão disponíveis com a API de transmissão de vídeo escolhida.

As coisas podem e vão correr mal ocasionalmente, uma vez que há tantas peças a funcionar. Erros no seu código ou no próprio sistema podem fazer com que as coisas parem. No entanto, com uma plataforma de apoio ao cliente de qualidade, é possível resolver rapidamente os problemas que ocorrem.

As plataformas que está a considerar têm um suporte técnico sólido? Oferecem comunidades de apoio para partilhar problemas e melhores práticas com outras pessoas que estão a utilizar o mesmo produto? Transmissão de vídeo em direto API? Para obter a melhor experiência de visualização, pretende um serviço de transmissão de API que tenha o apoio necessário.

Estas considerações podem influenciar a sua preferência por uma API de transmissão de vídeo em direto em detrimento de outra.

8. A API de transmissão em direto é RESTful?

REST é uma abreviatura de “transferência de estado representacional.” Trata-se de um estilo arquitetónico para a comunicação na Web. REST é uma abordagem normalizada que utiliza componentes, conectores e elementos de dados num sistema de hipermédia distribuído. Toda a Internet utiliza REST, mas também foi adaptada para APIs.

Uma API RESTful é rápida, escalável, simples e fiável. Também é previsível. Nem todas as APIs seguem a norma REST, mas é o estilo mais popular atualmente.

Recomendamos que procure uma API RESTful em vez de uma arquitetura diferente.

API de transmissão de vídeo em fluxo contínuo no Dacast

Neste momento, já deve ter uma ideia melhor do que procurar num OVP para acesso à API de transmissão de vídeo. Felizmente, a Dacast preenche todos os 8 requisitos que discutimos acima com o nosso acesso à API RESTful para a API de vídeo e a API de leitor.

A Dacast lançou recentemente algumas actualizações à documentação da nossa API. A nossa API de transmissão de vídeo suporta a gestão de conteúdos para transmissão em direto, alojamento VOD e organização de listas de reprodução.

A nossa API também pode ser utilizada para personalizar as operações de análise de vídeo. O Dacast é uma opção forte de API de transmissão de vídeo.

API de transmissão em direto (gestão de conteúdos)

O Dacast tem muitos comandos para gerir as transmissões em direto, incluindo:

• Listar transmissões em direto (GET)
• Criar uma nova transmissão em direto (POST)
• Eliminar uma transmissão em direto (DELETE)
• Recuperar detalhes da transmissão em direto (GET)
• Atualizar detalhes da transmissão em direto (PUT)
• Recuperar o código de incorporação da transmissão em direto (GET)
• Eliminar o ecrã inicial personalizado (DELETE)
• Carregar ecrã inicial personalizado (POST)
• Eliminar miniatura personalizada (DELETE)
• Carregar miniatura personalizada (POST)

Para aceder à documentação da gestão da API de transmissão em direto, navegue até à Documentação da API do Dacast página. Clique em “01 – LIVE STREAMS” e, em seguida, escolha “1.1 Gestão de conteúdos”. Os utilizadores podem clicar nas diferentes funções para aceder aos comandos de cada uma.

As transmissões em direto requerem um raciocínio rápido e, com as funções correctas das API de transmissão em direto, pode gerir mais facilmente as suas transmissões em direto com o Dacast.

API VOD (Gestão de conteúdos)

A Dacast oferece documentação para vários comandos da API de gerenciamento de VOD, incluindo:

• Listar ficheiros VOD (GET)
• Carregar ou integrar um ficheiro de vídeo (POST)
• Eliminar o splash do ID VOD (DELETE)
• Carregar ecrã inicial personalizado (POST)
• Carregar miniatura personalizada (POST)
• Apagar ficheiro VOD (DELETE)
• Recuperar detalhes de VOD (GET)
• Atualizar detalhes VOD (PUT)
• Gerar código de incorporação VOD (GET)

O acesso à documentação da API VOD no Dacast é muito semelhante ao acesso à documentação de transmissão ao vivo. Navegar para o Documentação da API do Dacast página. Clique em “02 – VÍDEO A PEDIDO” e, em seguida, seleccione “2.1 Gestão de conteúdos”. A partir daí, pode clicar nos comandos de cada função.

Estas funções facilitam a experiência de transmissão da API no back-end.

API de lista de reprodução de vídeo (gestão de conteúdos)

As funções da API de gestão de conteúdos de listas de reprodução do Dacast incluem:

• Listar listas de reprodução (GET)
• Criar uma nova lista de reprodução (POST)
• Apagar uma lista de reprodução (DELETE)
• Recuperar pormenores da lista de reprodução (GET)
• Atualizar detalhes da lista de reprodução (PUT)
• Atualizar o conteúdo de uma lista de reprodução (PUT)
• Devolver o código de incorporação da lista de reprodução (GET)
• Eliminar o ecrã inicial personalizado (DELETE)
• Carregar ecrã inicial personalizado (POST)
• Eliminar miniatura personalizada (DELETE)
• Carregar miniatura personalizada (POST)

Tal como a documentação da API de VOD e de transmissão em direto, os utilizadores podem aceder à Documentação da API do Dacast para encontrar a documentação da API da lista de reprodução de vídeos. Seleccione “03 – LISTAS DE REPRODUÇÃO” e clique em “3.1 Gestão de conteúdos” para ver os separadores de documentação de cada função.

Estas funções de gestão de conteúdos da API tornam mais simples a gestão dos conteúdos que aloja no seu sítio Web.

API de análise de vídeo (operações)

A Dacast também oferece uma API para operações de análise. Existem duas funções principais da API analítica. Permite-lhe gerar análises relacionadas com um determinado tipo de conteúdo ou com uma parte específica do conteúdo.

Para aceder à documentação relativa à análise, consulte a Documentação da API do Dacast e seleccione “04 – ANALYTICS” e, em seguida, clique em “3.1 Analytics Operations”.

Na documentação de ambas as funções de análise, o utilizador pode escolher um tipo de gráfico e um tipo de conteúdo.

Os tipos de gráficos incluem:

• Bytes por período
• Bytes por conteúdo
• Visitantes por período
• Visitantes por conteúdo
• Visitantes por país

Os tipos de conteúdo incluem:

• Vídeo a pedido (VOD)
• Transmissão em direto
• Listas de reprodução

Pode configurar as definições para gerar os relatórios específicos que pretende rever.

Com o Dacast, pode obter as análises de que necessita para personalizar e melhorar ainda mais a sua configuração de transmissão de API.

Aceder à documentação da API do Dacast

Toda a documentação da nossa API está organizada no nosso sítio Web na nossa Documentação da API página. Esta documentação inclui todas as instruções e comandos necessários para personalizar as funções de gestão de conteúdos e operações analíticas que discutimos acima.

Facilitamos a utilização da API de streaming para criar uma experiência de conteúdos que se adapte às necessidades dos seus espectadores e da sua empresa.

O Dacast suporta API do leitor e SDKs móveis também. Estas ferramentas foram concebidas para ajudar a personalizar o leitor de vídeo HTML5 Dacast e a criar aplicações móveis de transmissão. Pode chegar a uma grande audiência utilizando as ferramentas de transmissão do Dacast.

Comparação de outros fornecedores de API de transmissão de vídeo

Embora o Dacast seja um poderoso software de transmissão com acesso fiável à API, a maioria dos organismos de radiodifusão quer ter a certeza de que está a escolher a melhor solução possível. A melhor maneira de o fazer é explorar outras opções no mercado.

Vejamos as características das ofertas de API de transmissão de vídeo das principais soluções de alojamento de vídeo e ver como o Dacast se compara. Dessa forma, pode escolher o melhor software de transmissão com acesso à API para as suas necessidades.

1. Dacast

• JSON Transmissão em direto RESTful API
• Documentação fácil de seguir
• API de gestão de conteúdos: criar, apagar e editar em massa
• Operações analíticas
• Integração simples com aplicações e serviços externos
• Concebido para uma experiência óptima do utilizador
• Ambiente de teste em caixa de areia
• Equipa de apoio API dedicada
• API do jogador
• Leitor SDK

2. Vídeo da IBM Cloud

• Criar bases de dados de vídeo para os espectadores
• Suporta alojamento VOD
• Anúncios para utilizadores gratuitos; sem anúncios para utilizadores premium
• Integra-se com análises avançadas

3. Transmissão em direto

• API RESTful JSON
• API de transmissão em direto
• API do jogador
• Canal API
• Documentado exaustivamente

4. YouTube em direto

• API de gestão de conteúdos: criar, editar e gerir transmissões em direto
• API de transmissão em direto
• Programação da difusão
• API de dados do YouTube

5. Brightcove

• Sistema de gestão de conteúdos de vídeo
• Organizar informações sobre vídeos
• API RESTful
• Tokens API
• Transcrição do vídeo
• Incorporação de suportes de vídeo na nuvem

Estes são os cinco principais fornecedores de streaming da API de alojamento de vídeo com que pode trabalhar para distribuir o seu conteúdo a um público mais vasto. Têm a tecnologia e o apoio de que necessita para criar uma solução API de difusão de vídeo personalizada.

Conclusão: Que API vai escolher?

A utilização da API de transmissão de vídeo tem muitas vantagens. Escolher um vídeo em direto O streaming de API é uma decisão importante e requer um pouco de conhecimento. Se abordar os oito pontos que discutimos nesta publicação, não deverá ter problemas em escolher a plataforma de transmissão correcta para o acesso à API.

As informações que descrevemos devem servir como um guia fiável no seu processo de escolha de API. Esperamos ter-lhe dado as informações e a confiança de que necessita para tomar uma decisão informada.

O Dacast suporta API para alojamento de vídeo, gestão de conteúdos e leitores de vídeo personalizados. A nossa API RESTful está completamente documentada, tornando-a acessível a emissoras com todos os níveis de experiência.

Inscrever-se em Dacast hoje para explorar as integrações de API. Os seus primeiros 14 dias são gratuitos, para que possa experimentar todas as fantásticas funcionalidades antes de decidir comprar um plano de preços que se adeqúe às suas necessidades.

COMEÇAR GRATUITAMENTE

Gostaríamos de saber a opinião do nosso público sobre esta questão! Que APIs utilizou no passado? Que características são importantes para si? Como planeia integrar o vídeo em direto nos seus sistemas existentes? Quais são os desafios que enfrenta? Que novas funcionalidades procura numa API de transmissão de vídeo em direto?

Informe-nos através do chat ou contacte o suporte 24/7! Responderemos e aguardamos com expetativa o diálogo.

Para obter dicas regulares sobre transmissão em direto e ofertas exclusivas, pode também juntar-se ao grupo Dacast no LinkedIn.