Base64 編碼

將影片傳送至 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());