QRコードをリアルタイムで生成することは、モバイル決済、イベントチケット、在庫管理に不可欠です。
Aspose.BarCode Cloud SDK for Python を使用すると、Python アプリケーションから直接高品質な QR コードを作成できます。
このガイドでは、認証情報の設定から色のカスタマイズ、ロゴの埋め込みまで、Aspose.BarCode クラウド Python QR コードワークフローを順に解説します。さらに、複数のコードを一括生成し、REST 統合のための同等の cURL コマンドを使用する方法も学べます。
Aspose.BarCode クラウド Python QR コードライブラリは、ロゴの追加やエラー訂正レベルの調整もサポートしており、スキャンの信頼性を向上させます。
開始前の準備: 前提条件とインストール
開始する前に、以下が揃っていることを確認してください:
- 開発マシンに Python 3.7 以上がインストールされていること。
- client_id と client_secret の値を持つ Aspose Cloud アカウント。
- 生成された PNG ファイルを保存するフォルダーへのアクセス。
SDK を pip でインストールします:
pip install aspose-barcode-cloud
最新のパッケージをダウンロードし、リリースノートはダウンロードページで確認できます。
次に、認証情報を使用して API クライアントを構成します(完全スクリプトからの抜粋):
from asposebarcodecloud import BarCodeApi, ApiClient, Configuration
API_CLIENT_ID = "YOUR_CLIENT_ID"
API_CLIENT_SECRET = "YOUR_CLIENT_SECRET"
config = Configuration()
config.host = "https://api.aspose.cloud"
config.api_key['client_id'] = API_CLIENT_ID
config.api_key['client_secret'] = API_CLIENT_SECRET
barcode_api = BarCodeApi(ApiClient(config))
SDK をインストールし、認証情報を設定すると、QR コードの生成の準備が整います。
Aspose.BarCode Cloud SDK for Python を使用したカスタム QR コード生成のステップバイステップガイド
このステップバイステップガイドでは、Aspose.BarCode クラウド Python QR コード API を使用して、完全にカスタマイズされた QR 画像を作成する方法を示します。
ステップ 1: ソース ドキュメントを読み込み、資格情報を設定する
まず、必要なモジュールをインポートし、上記のように BarCodeApi インスタンスを作成します。これにより、ライブラリが Aspose クラウドサービスと通信できるようになります。
ステップ 2: QRコードパラメータの定義
QRコードのオプション(タイプ、テキスト、フォーマット、カラー、エラー訂正レベル)を保持する辞書を作成します。
params = {
"type": "QR",
"text": "https://example.com",
"format": "png",
"foreColor": "Black",
"backColor": "White",
"qrErrorLevel": "LevelQ"
}
各パラメータの詳細については、BarCode API リファレンスをご覧ください。
ステップ 3: 任意のロゴを埋め込む
ロゴを追加したい場合は、画像ファイルを読み取り、Base64 に変換し、パラメーターに追加します。
def read_logo_as_base64(logo_path: str) -> str:
with open(logo_path, "rb") as logo_file:
return base64.b64encode(logo_file.read()).decode('utf-8')
if logo_path and os.path.isfile(logo_path):
params["logo"] = read_logo_as_base64(logo_path)
このステップでは、ロゴ付き QR コードを生成する Aspose.BarCode sdk 機能をデモンストレーションします。
ステップ 4: QR コードの生成と保存
get_barcode_generate メソッドを呼び出し、返されたバイトをファイルに書き込みます。
result_bytes = barcode_api.get_barcode_generate(**params)
with open(output_path, "wb") as out_file:
out_file.write(result_bytes)
print(f"QR code saved to: {output_path}")
ステップ 5: 複数のQRコードを一括生成(オプション)
テキストとファイル名のリストをループして、1回の実行で複数の QR コードを作成します。
qr_items = [
{"text": "https://example.com/product/1", "filename": "qr_product_1.png"},
{"text": "Contact: +1-800-555-0199", "filename": "qr_contact.png"}
]
for item in qr_items:
output_file = os.path.join("generated_qrcodes", item["filename"])
generate_qr_code(text=item["text"], output_path=output_file, **common_settings)
これは簡潔なループで batch generate QR codes Python Aspose を示しています。
完全なコード例: カスタム設定によるバッチ QR コード生成
以下のスクリプトは、すべての要素を組み合わせ、バッチサポート付きの Aspose.BarCode cloud Python QR コード生成プロセスをデモンストレーションします。
import os
import base64
from asposebarcodecloud import BarCodeApi, ApiClient, Configuration, ApiException
# -------------------- Configuration --------------------
# Replace with your actual Aspose Cloud credentials
API_CLIENT_ID = "YOUR_CLIENT_ID"
API_CLIENT_SECRET = "YOUR_CLIENT_SECRET"
config = Configuration()
config.host = "https://api.aspose.cloud"
config.api_key['client_id'] = API_CLIENT_ID
config.api_key['client_secret'] = API_CLIENT_SECRET
# Initialize API instance
barcode_api = BarCodeApi(ApiClient(config))
# -------------------- Helper Functions --------------------
def read_logo_as_base64(logo_path: str) -> str:
"""Read an image file and return its Base64 representation."""
with open(logo_path, "rb") as logo_file:
return base64.b64encode(logo_file.read()).decode('utf-8')
def generate_qr_code(
text: str,
output_path: str,
fore_color: str = "Black",
back_color: str = "White",
error_correction: str = "LevelQ", # Options: LevelL, LevelM, LevelQ, LevelH
logo_path: str = None,
image_format: str = "png"
) -> None:
"""
Generates a QR code with optional customizations and saves it to disk.
"""
try:
# Prepare optional parameters
params = {
"type": "QR",
"text": text,
"format": image_format,
"foreColor": fore_color,
"backColor": back_color,
"qrErrorLevel": error_correction
}
# If a logo is supplied, embed it as a Base64 string
if logo_path and os.path.isfile(logo_path):
params["logo"] = read_logo_as_base64(logo_path)
# Call the Aspose.BarCode Cloud API
result_bytes = barcode_api.get_barcode_generate(**params)
# Write the resulting image to the specified file
with open(output_path, "wb") as out_file:
out_file.write(result_bytes)
print(f"QR code saved to: {output_path}")
except ApiException as e:
print(f"API Exception when generating QR for '{text}': {e}")
# -------------------- Batch Generation Example --------------------
def batch_generate_qr_codes():
"""
Generates multiple QR codes in a loop with varying texts and customizations.
"""
# Sample data for batch processing
qr_items = [
{"text": "https://example.com/product/1", "filename": "qr_product_1.png"},
{"text": "https://example.com/product/2", "filename": "qr_product_2.png"},
{"text": "https://example.com/product/3", "filename": "qr_product_3.png"},
{"text": "Contact: +1-800-555-0199", "filename": "qr_contact.png"},
{"text": "Wi‑Fi: MyNetwork;P:password123;;", "filename": "qr_wifi.png"}
]
# Common customization settings
fore_color = "DarkBlue"
back_color = "LightYellow"
error_correction = "LevelH"
logo_path = "logo.png" # Ensure this file exists in the working directory
output_dir = "generated_qrcodes"
os.makedirs(output_dir, exist_ok=True)
for item in qr_items:
output_file = os.path.join(output_dir, item["filename"])
generate_qr_code(
text=item["text"],
output_path=output_file,
fore_color=fore_color,
back_color=back_color,
error_correction=error_correction,
logo_path=logo_path,
image_format="png"
)
# -------------------- Execution --------------------
if __name__ == "__main__":
batch_generate_qr_codes()
注意: このコード例は基本機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値を実際の環境に合わせて更新し、必要な依存関係がすべて正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント を参照するか、サポートチーム にお問い合わせください。
cURL を使用した REST API による QR コードの生成
純粋なRESTアプローチを好む場合は、cURLコマンドを使用して同じ結果を得るために、Aspose.BarCode cloud Python QR code endpoint を利用できます。
1. アクセストークンの取得
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
レスポンスには、以降の呼び出しで使用する access_token が含まれています。
2. QRコードを生成する
必要に応じて YOUR_ACCESS_TOKEN を置き換え、クエリ パラメータを調整してください。
curl -X GET "https://api.aspose.cloud/v3.0/barcode/generate?type=QR&text=HelloWorld&format=png&foreColor=DarkBlue&backColor=LightYellow&qrErrorLevel=LevelH" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o qr_helloworld.png
ロゴを埋め込むには、まず画像を Base64 に変換し、logo パラメータで渡します。
3. バッチ生成 (ループ例)
Bash または PowerShell でループをスクリプト化し、テキストのリストを反復処理して、上記の GET リクエストを各エントリに対して呼び出し、結果を別々のファイル名で保存できます。
完全な API の詳細については、公式 API ドキュメントをご参照ください。
カスタマイズオプション: 色、ロゴ、エラー訂正
SDK は、QR コードの外観と耐久性を調整できる複数のパラメーターを提供します。
- foreColor - 前景(モジュール)カラーを設定します。例:
"DarkBlue"。 - backColor - 背景色を設定します。例:
"LightYellow"。 - qrErrorLevel - 誤り訂正レベルを制御します。オプションは
LevelL,LevelM,LevelQ,LevelHです。レベルが高いほどデータ容量が減少する代わりに堅牢性が向上します。 - logo - QRコードの中心に配置される Base64 エンコードされた画像です。
以下は、これらのオプションがリクエスト辞書に組み立てられる様子を示すスニペットです:
params = {
"type": "QR",
"text": "https://example.com",
"format": "png",
"foreColor": "DarkBlue",
"backColor": "LightYellow",
"qrErrorLevel": "LevelH",
"logo": read_logo_as_base64("logo.png") # optional
}
値を調整して、ブランドガイドラインやビジュアルデザイン要件に合わせてください。
よくある質問
-
Aspose.BarCode Python を使用して、コードをあまり書かずにカスタム QR コードを作成するにはどうすればよいですか?
SDK は重い処理を抽象化します。params辞書にいくつかのパラメータを設定し、get_barcode_generateを呼び出すだけで、すぐに使用できる QR 画像が取得できます。 -
サーバーレスプラットフォームでロゴ付きQRコードを生成することは、Aspose.BarCode SDKで可能ですか?
はい。このライブラリは、AWS LambdaやAzure Functionsを含む任意のPython環境で動作します。実行環境がhttps://api.aspose.cloudにアクセスできる限り利用できます。 -
What does the python script for QR code generation Aspose return?
get_barcode_generateメソッドは、生の画像バイト列を返します。これらはファイルに直接書き込んだり、Web 応答のストリームに送ったりできます。 -
ブランドのパレットに合わせて Aspose.BarCode Python の QR コードの色をカスタマイズするにはどうすればよいですか?
foreColorとbackColorパラメータを、API がサポートする任意の HTML カラー名または HEX 値で使用してください。 -
ライセンスオプションは何ですか、また一時ライセンスはどのように取得できますか?
フルライセンスは Aspose のウェブサイトで購入できます。評価目的の場合は、一時ライセンスページ から一時ライセンスをリクエストできます。