授權
概觀
Aspose.Slides for Python via Java 可以在評估模式或授權模式下執行。在評估模式下,它會在每個儲存的簡報的每張投影片上加入評估浮水印文字方塊,並截斷程式碼從簡報讀取的文字。本文說明如何從檔案或位元組套用授權,以及如何設定計量授權。
如需購買方案,請參閱定價資訊。如需一般授權與購買問題,請參閱購買政策與常見問題。
有關評估限制及如何請求暫時授權,請參閱評估 Aspose.Slides。暫時授權的套用方式與購買授權檔案相同。
關於授權
授權檔案包含產品名稱、授權開發人員數量、以及訂閱到期日等資訊。該檔案為以數位簽章的 XML。
警告
請勿編輯授權檔案。即使多一個換行也會使其數位簽章失效。在應用程式或處理程序啟動時只套用一次授權,於建立簡報或執行其他 Aspose.Slides 作業之前套用。若使用授權檔案,請使用License類別。計量授權則以公鑰與私鑰配對取代授權檔案。
套用授權
以下範例假設已安裝 Aspose.Slides for Python via Java 及其前置需求。每個範例都是獨立腳本,會啟動 JVM、匯入 API,並套用授權。在您的應用程式中,請於套用授權後執行簡報操作,並於所有 Aspose.Slides 工作完成後再關閉 JVM。
從檔案套用授權
將授權檔案路徑傳遞給License.setLicense。將 Aspose.Slides.lic 替換為您的授權檔案路徑。
from pathlib import Path
import jpype
import asposeslides
jpype.startJVM()
try:
from asposeslides.api import License
license_path = Path("Aspose.Slides.lic")
if license_path.is_file():
license = License()
license.setLicense(str(license_path))
print("Licensed:", license.isLicensed())
# 在此執行簡報操作,在關閉 JVM 之前。
else:
print("License file not found. Set the path to your license file.")
finally:
jpype.shutdownJVM()
使用完整的檔名,包含副檔名。例如,若檔名為 Aspose.Slides.lic.xml,請在路徑中加入 .xml。使用絕對路徑可避免應用程式工作目錄的歧義。
範例使用License.isLicensed來檢查授權是否已套用。
從位元組套用授權
當授權以 Python 位元組形式提供時,請使用License.setLicenseFromBytes。以下範例以二進位模式讀取檔案,並在套用授權前關閉檔案。
from pathlib import Path
import jpype
import asposeslides
jpype.startJVM()
try:
from asposeslides.api import License
license_path = Path("Aspose.Slides.lic")
if license_path.is_file():
with license_path.open("rb") as license_file:
license_data = license_file.read()
license = License()
license.setLicenseFromBytes(license_data)
print("Licensed:", license.isLicensed())
# 在此執行簡報操作,在關閉 JVM 之前。
else:
print("License file not found. Set the path to your license file.")
finally:
jpype.shutdownJVM()
保持原始位元組不變。套用前請勿解碼、重新格式化或以其他方式修改授權內容。
套用計量授權
計量授權會根據 API 使用量計費。取得計量授權後,請使用Metered.setMeteredKey套用其公鑰與私鑰。於應用程式啟動時初始化Metered物件,並一次性套用金鑰。
以下範例從環境變數 ASPOSE_METERED_PUBLIC_KEY 與 ASPOSE_METERED_PRIVATE_KEY 讀取金鑰。請在執行腳本前設定這兩個變數。
import os
import jpype
import asposeslides
jpype.startJVM()
try:
from asposeslides.api import Metered
public_key = os.environ.get("ASPOSE_METERED_PUBLIC_KEY")
private_key = os.environ.get("ASPOSE_METERED_PRIVATE_KEY")
if public_key and private_key:
metered = Metered()
metered.setMeteredKey(public_key, private_key)
# 在此執行簡報操作,在關閉 JVM 之前。
else:
print("Set both metered licensing environment variables before running this example.")
finally:
jpype.shutdownJVM()
注意
計量授權需要網際網路連線以驗證金鑰並回報使用情況。請將私鑰保留在程式碼與日誌之外。詳情請參閱計量授權常見問答 ,以了解連線與計費資訊。常見問題
購買授權後,我需要安裝不同的套件嗎?
不需要。請對您在評估時使用的相同套件套用授權。
我需要為每個簡報都套用授權嗎?
不需要。請在應用程式啟動時一次套用,於建立或載入簡報之前。
我可以重新命名授權檔案嗎?
可以。請在程式碼中使用新的完整檔名,且保持檔案內容不變。
我可以在基於位元組的範例中使用暫時授權嗎?
可以。請以位元組方式讀取暫時授權檔案,並以與購買授權相同的方式套用。