客戶端渲染中的遙測

警告 — 實驗性功能：此功能隨時可能出現錯誤和重大變更。請在 GitHub 上追蹤進度，並在 Discord 的 #web-renderer 頻道中參與討論。

客戶端渲染透過 @remotion/licensing 套件發送遙測資料，每次使用渲染功能時均會觸發事件。

Remotion 的授權政策對個人和小型公司免費，但較大型的公司需要購買付費授權，費用依渲染次數計算。

發送的資訊

系統會發送以下資訊：

IP 位址
網域名稱（例如 https://remotion.dev）
是在生產環境還是開發環境中渲染
渲染的是影片還是靜態圖片

不會收集任何關於渲染影片的內容或中繼資料，也不會收集任何使用者資料。

遙測系統的設計旨在盡可能收集最少的資料，同時確保可追責性。若設定了授權金鑰，企業可輕鬆追蹤其渲染次數。

設定授權金鑰

免費授權資格

如果你符合免費授權資格，不需要申請授權金鑰。在 licenseKey 中傳入 "free-license" 即可停用控制台中的警告訊息，並聲明你符合免費授權資格。

聲明免費授權資格

import {renderMediaOnWeb} from '@remotion/web-renderer';
 
const Component: React.FC = () => null;
 
const composition = {
  component: Component,
  durationInFrames: 100,
  fps: 30,
  width: 100,
  height: 100,
  calculateMetadata: null,
  id: 'my-composition',
};
 
await renderMediaOnWeb({
  composition,
  inputProps: {},
  licenseKey: 'free-license',
});

付費授權金鑰

如果你持有 Remotion 公司授權或企業授權，請前往 remotion.pro，在「Usage」分頁取得你的授權金鑰。

設定付費授權金鑰

import {renderMediaOnWeb} from '@remotion/web-renderer';
 
await renderMediaOnWeb({
  composition,
  inputProps: {},
  licenseKey: 'rm_pub_abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890',
});

追蹤客戶端渲染時，應使用公開金鑰（rm_pub_ 開頭）。你可以在同一個「Usage」分頁上追蹤使用量。

注意：使用量目前尚未（與帳單掛鉤）。你需要定期手動更新渲染次數以反映實際使用情況。

在環境變數中管理金鑰

建議將授權金鑰存放在環境變數中，避免硬編碼在原始碼裡：

使用環境變數管理授權金鑰

import {renderMediaOnWeb} from '@remotion/web-renderer';
 
await renderMediaOnWeb({
  composition,
  inputProps: {},
  licenseKey: process.env.REMOTION_LICENSE_KEY ?? 'free-license',
});

在 .env 檔案中設定：

.env

REMOTION_LICENSE_KEY=rm_pub_your_actual_key_here

安全提醒：客戶端渲染發生在瀏覽器中，因此客戶端可見的授權金鑰應使用公開金鑰（rm_pub_ 前綴），而非私密的伺服器金鑰。

授權等級說明

使用情境	所需授權	licenseKey 設定
個人專案	免費	`"free-license"`
年收入低於 $10 萬的公司	免費	`"free-license"`
年收入超過 $10 萬的公司	付費授權	公司/企業金鑰

詳細授權條款請參閱 Remotion 授權說明。