Quando transmite vídeo para a Video Intelligence API, pode transmitir um URI do Cloud Storage ou incorporar dados de vídeo diretamente no campo content
do pedido, que tem de ser codificado em base64.
Usar a linha de comandos
Num pedido gRPC, pode simplesmente escrever dados binários diretamente; no entanto, o JSON é usado quando faz um pedido REST. O JSON é um formato de texto que não suporta diretamente dados binários, pelo que tem de converter esses dados binários em texto através da codificação Base64.
A maioria dos ambientes de programação contém um utilitário base64
nativo para codificar um ficheiro binário em dados de texto ASCII. Para codificar um ficheiro:
Linux
Codifique o ficheiro através da ferramenta de linha de comandos base64
, certificando-se de que
impede a mudança de linha com a marca -w 0
:
base64 INPUT_FILE -w 0 > OUTPUT_FILE
macOS
Codifique o ficheiro com a ferramenta de linha de comandos base64
:
base64 -i INPUT_FILE -o OUTPUT_FILE
Windows
Codifique o ficheiro com a ferramenta Base64.exe
:
certutil -encodehex SOURCE_VIDEO_FILE > DEST_TEXT_FILE 0x40000001
PowerShell
Codifique o ficheiro através do método Convert.ToBase64String
:
[Convert]::ToBase64String([IO.File]::ReadAllBytes("./INPUT_FILE")) > OUTPUT_FILE
Crie um ficheiro de pedido JSON, incorporando os dados codificados em base64:
JSON
{ "requests":[ { "image":{ "content": "ZkxhQwAAACIQABAAAAUJABtAA+gA8AB+W8FZndQvQAyjv..." }, "features": [ { "type":"LABEL_DETECTION", "maxResults":1 } ] } ] }
Usar bibliotecas de cliente
Incorporar dados binários em pedidos através de editores de texto não é desejável nem prático. Na prática, vai incorporar ficheiros codificados em base64 no código do cliente. Todas as linguagens de programação suportadas têm mecanismos incorporados para codificar conteúdo em base64.
Python
Em Python, codifique os ficheiros de vídeo em base64 da seguinte forma:
# Import the base64 encoding library.
import base64
# Pass the video data to an encoding function.
def encode_video(video):
video_content = video.read()
return base64.b64encode(video_content)
Node.js
No Node.js, codifique os ficheiros de vídeo em base64 da seguinte forma:
// Read the file into memory.
var fs = require('fs');
var videoFile = fs.readFileSync('/path/to/file');
// Convert the video data to a Buffer and base64 encode it.
var encoded = new Buffer(videoFile).toString('base64');
Java
Em Java, pode codificar ficheiros de imagem em base64 da seguinte forma:
// Import the Base64 encoding library.
import org.apache.commons.codec.binary.Base64;
// Encode the video.
byte[] videoData = Base64.encodeBase64(videoFile.getBytes());