將網頁轉換為高解析度圖像是報告、縮圖製作和電子郵件渲染的常見需求。
Aspose.CAD Cloud SDK for Node.js 提供了一個強大的解決方案，可簡化在伺服器上直接將 HTML 轉換為 JPG 的過程。
本指南將帶領您完成 SDK 的安裝、憑證配置、編寫轉換程式碼，以及使用 cURL 的 REST API，讓您能將 HTML‑to‑JPG 轉換功能嵌入任何 Node.JS 應用程式中。

在 Node.JS 中將 HTML 轉換為 JPG 的步驟

  1. 設定 Aspose.CAD Cloud 憑證：建立一個設定物件，並設定您的 client ID 與 client secret。
const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
  1. 建立 CAD API 實例：使用設定來實例化 API 用戶端。
const cadApi = new CadApi.CadApi(config);
  1. 定義輸入 HTML 和輸出 JPG 路徑：解析來源 HTML 檔案和目標 JPG 檔案的絕對路徑。
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
  1. 準備轉換請求: 附加 HTML 檔案的可讀串流，並將輸出格式指定為 jpg。
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
  1. 執行轉換並儲存 JPG：呼叫 convert，接收 Buffer，並寫入磁碟。這完成了在 Node.JS 中將 HTML 轉換為 JPG 的過程。
try {
    const resultBuffer = await cadApi.convert(request);
    fs.writeFileSync(outputPath, resultBuffer);
    console.log('Conversion completed. JPG saved to:', outputPath);
} catch (err) {
    console.error('Error during conversion:', err);
}

如需詳細的類別資訊，請參考 API Reference。

HTML 轉 JPG 轉換的完整範例

以下範例展示了從頭到尾的完整工作流程。

const fs = require('fs');
const path = require('path');
const CadApi = require('asposecadcloud');

async function convertHtmlToJpg() {
    // Configure Aspose.CAD Cloud credentials
    const config = new CadApi.Configuration();
    config.clientId = 'YOUR_CLIENT_ID';
    config.clientSecret = 'YOUR_CLIENT_SECRET';

// Create API instance
    const cadApi = new CadApi.CadApi(config);

// Define input HTML and output JPG paths
    const inputPath = path.resolve(__dirname, 'sample.html');
    const outputPath = path.resolve(__dirname, 'sample.jpg');

// Prepare request with a readable stream and target format
    const request = new CadApi.ConvertRequest();
    request.inputFile = fs.createReadStream(inputPath);
    request.format = 'jpg';

try {
        // Perform conversion; result is a Buffer containing JPG data
        const resultBuffer = await cadApi.convert(request);
        // Write the JPG buffer to the output file
        fs.writeFileSync(outputPath, resultBuffer);
        console.log('Conversion completed. JPG saved to:', outputPath);
    } catch (err) {
        console.error('Error during conversion:', err);
    }
}

// Execute the conversion
convertHtmlToJpg();

注意： 此程式碼範例示範了核心功能。在將其用於您的專案之前，請確保更新所有檔案路徑和設定值以符合實際環境，驗證所有必要的相依項目已正確安裝，並在開發環境中徹底測試。如遇任何問題，請參閱官方文件或聯繫支援團隊尋求協助。

使用 cURL 從 HTML 生成 JPG

您可以透過 REST API 完成相同的轉換。以下是所需的 cURL 命令。

  1. 取得存取權杖
    將 YOUR_CLIENT_ID 和 YOUR_CLIENT_SECRET 替換為您的憑證。
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. 上傳來源 HTML 檔案
    使用先前步驟的存取權杖。
curl -X PUT "https://api.aspose.cloud/v3.0/cad/storage/file/sample.html" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: text/html" \
--data-binary "@sample.html"
  1. 請求轉換為 JPG
    format 查詢參數指定目標格式。
curl -X POST "https://api.aspose.cloud/v3.0/cad/convert?format=jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@sample.html" \
-o sample.jpg
  1. 下載產生的 JPG（if you used a different endpoint for conversion）。
curl -X GET "https://api.aspose.cloud/v3.0/cad/storage/file/sample.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample.jpg

如需更多詳細資訊，請參閱官方 API 文件。

安裝與設定 Aspose.CAD Cloud SDK for Node.JS

使用 npm 安裝 SDK：

npm install @asposecloud/aspose-cad-cloud

此套件可於Release page下載。
請確保已安裝 Node.js 12 或更高版本，且已建立 Aspose Cloud 帳戶以取得您的 clientId 和 clientSecret。

Aspose.CAD Cloud SDK 生成圖像的功能

  • HTML to JPG conversion - 直接將 HTML 頁面渲染為高品質的 JPG 圖像，無需中間步驟。
  • Stream‑based processing - 接受可讀取的串流作為輸入，適用於大型檔案或從記憶體讀取的情況。
  • Multiple output formats - 除了 JPG，SDK 還支援 PNG、BMP、GIF、以及 TIFF，提供彈性的圖像生成。
  • Cloud‑hosted rendering engine - 利用 Aspose 的雲端基礎設施，實現快速且可靠的轉換。
  • Comprehensive API reference - 線上 API 參考提供完整的方法簽名、必需與可選參數、驗證流程、請求/回應結構與錯誤代碼，並附有數十個語言特定的程式碼片段（C#, Java, Python, Node.js），說明常見任務，如 CAD 轉 JPG、圖像品質調整與串流輸入處理。請參閱 API Reference。

結論

您現在已了解如何在 Node.JS 中使用功能強大的 Aspose.CAD Cloud SDK for Node.js 將 HTML 轉換為 JPG。SDK 處理憑證管理、串流處理和格式選擇，為您提供可直接執行的伺服器端圖像生成解決方案。請記得從臨時許可頁面取得測試用的臨時許可，並在正式部署時購買完整許可。祝編程愉快！

常見問題

如何在 Node.JS 中使用 Aspose.CAD 將 HTML 轉換為 JPG？
使用 Aspose.CAD Cloud SDK for Node.js 建立 ConvertRequest，將 format 設為 'jpg'，然後呼叫 convert 方法。本文中的完整程式碼範例展示了具體步驟。

轉換是本地執行還是雲端執行？
SDK 會將請求發送至 Aspose.CAD Cloud 服務，因此處理在雲端進行，同時您的 Node.JS 程式碼負責協調工作流程。

支援哪些檔案格式作為輸入與輸出？
SDK 支援廣泛的 CAD 與影像格式。對於 HTML 轉影像的轉換，您可以輸出 JPG、PNG、BMP、GIF 或 TIFF。請參閱 API 參考 以取得完整清單。

我需要為生產環境購買授權嗎？
臨時授權可用於評估，請前往臨時授權頁面。在生產環境中，您必須從 Aspose 獲取商業授權。

Read More