將影片傳送至 Video Intelligence API 時,您可以傳送 Cloud Storage URI,也可以將影片資料直接嵌入要求的 content
欄位,但必須先以 base64 編碼。
使用指令列
在 gRPC 要求內,您只需直接寫出二進位資料即可;但是,當提出 REST 要求時,會使用 JSON。JSON 是一種文字格式,不直接支援二進位資料,因此您需要使用 Base64 編碼,將這類二進位資料轉換為文字。
大多數開發環境都包含原生 base64
公用程式,可將二進位資料編碼為 ASCII 文字資料。如要編碼檔案,請按照下列步驟操作:
Linux
使用 base64
指令列工具對檔案進行編碼,並使用 -w 0
標記確保不會換行:
base64 INPUT_FILE -w 0 > OUTPUT_FILE
macOS
使用 base64
指令列工具編碼檔案:
base64 -i INPUT_FILE -o OUTPUT_FILE
Windows
使用 Base64.exe
工具對檔案進行編碼:
certutil -encodehex SOURCE_VIDEO_FILE > DEST_TEXT_FILE 0x40000001
PowerShell
使用 Convert.ToBase64String
方法對檔案進行編碼:
[Convert]::ToBase64String([IO.File]::ReadAllBytes("./INPUT_FILE")) > OUTPUT_FILE
建立 JSON 要求檔案,並內嵌 base64 編碼資料:
JSON
{ "requests":[ { "image":{ "content": "ZkxhQwAAACIQABAAAAUJABtAA+gA8AB+W8FZndQvQAyjv..." }, "features": [ { "type":"LABEL_DETECTION", "maxResults":1 } ] } ] }
使用用戶端程式庫
透過文字編輯器將二進位資料嵌入要求中,既不理想也不實際。實際上,您會將 base64 編碼的檔案嵌入用戶端程式碼內。所有支援的程式設計語言都擁有適用於 base64 編碼內容的內建機制。
Python
在 Python 中,base64 編碼的影片檔如下:
# 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
在 Node.js 中,base64 編碼的影片檔如下:
// 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
在 Java 中,base64 編碼的圖片檔如下所示:
// Import the Base64 encoding library.
import org.apache.commons.codec.binary.Base64;
// Encode the video.
byte[] videoData = Base64.encodeBase64(videoFile.getBytes());