تولید کدهای QR به‌صورت لحظه‌ای برای پرداخت‌های موبایلی، بلیت‌های رویداد و ردیابی موجودی ضروری است. Aspose.BarCode Cloud SDK for Python به شما امکان می‌دهد کدهای QR با کیفیت بالا را مستقیماً از برنامه‌های Python خود ایجاد کنید. در این راهنما، ما جریان کار QR کدهای Python در Aspose.BarCode cloud را از تنظیم اعتبارنامه‌ها تا سفارشی‌سازی رنگ‌ها و افزودن لوگوها بررسی می‌کنیم. همچنین یاد خواهید گرفت چگونه به‌صورت دسته‌ای چندین کد تولید کنید و از دستورات cURL معادل برای یکپارچه‌سازی REST استفاده کنید. کتابخانه QR کد Python در Aspose.BarCode cloud همچنین از افزودن لوگوها و تنظیم سطوح تصحیح خطا برای اسکن مقاوم پشتیبانی می‌کند.

قبل از شروع: پیش‌نیازها و نصب

قبل از شروع، مطمئن شوید که موارد زیر را دارید:

  • Python 3.7 یا بالاتر نصب شده بر روی ماشین توسعه شما.
  • یک حساب Aspose Cloud با مقادیر client_id و client_secret.
  • دسترسی به پوشه‌ای که فایل‌های تولید شدهٔ 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 هستید.

راهنمای گام به گام برای تولید کدهای QR سفارشی با Aspose.BarCode Cloud SDK برای Python

این راهنمای گام‌به‌گام نشان می‌دهد چگونه با Aspose.BarCode ابری Python QR code API کار کنید تا تصاویر QR کاملاً سفارشی تولید کنید.

مرحله 1: بارگذاری سند منبع و تنظیم اعتبارها

ابتدا ماژول‌های مورد نیاز را وارد کنید و نمونه BarCodeApi را همان‌طور که در بالا نشان داده شد، ایجاد کنید. این کار کتابخانه را برای ارتباط با سرویس ابری Aspose آماده می‌کند.

مرحله ۲: تعریف پارامترهای کد QR

یک دیکشنری ایجاد کنید که گزینه‌های کد QR مانند نوع، متن، فرمت، رنگ‌ها و سطح تصحیح خطا را نگه دارد.

params = {
    "type": "QR",
    "text": "https://example.com",
    "format": "png",
    "foreColor": "Black",
    "backColor": "White",
    "qrErrorLevel": "LevelQ"
}

برای جزئیات بیشتر درباره هر پارامتر، به مرجع API بارکد مراجعه کنید.

مرحله ۳: درج یک لوگوی اختیاری

اگر می‌خواهید یک لوگو اضافه کنید، فایل تصویر را بخوانید، آن را به 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 (اختیاری)

در یک اجرای برنامه، بر روی فهرستی از متن‌ها و نام‌های فایل‌ها حلقه بزنید تا چندین کد 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)

این مثال تولید دسته‌ای کدهای QR با Python Aspose را در یک حلقهٔ مختصر نشان می‌دهد.

مثال کامل کد: تولید دسته‌ای کد QR با تنظیمات سفارشی

اسکریپت زیر تمام قطعات را کنار هم می‌گذارد و فرآیند تولید کد QR با پشتیبانی از دسته‌ای در Aspose.BarCode cloud Python را نشان می‌دهد.

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()

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، اطمینان حاصل کنید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روزرسانی کنید که با محیط واقعی شما مطابقت داشته باشد، بررسی کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند، و به‌صورت کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه کنید.

ایجاد کدهای QR با استفاده از REST API و cURL

اگر ترجیح می‌دهید از رویکرد کاملاً REST استفاده کنید، می‌توانید از نقطهٔ انتهایی QR کد Aspose.BarCode ابر برای Python با دستورات cURL برای دستیابی به همان نتیجه استفاده کنید.

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 - یک تصویر Base64‑encoded که در مرکز کد QR قرار می‌گیرد.

در زیر یک قطعه کد نشان می‌دهد که این گزینه‌ها چگونه در دیکشنری درخواست ترکیب می‌شوند:

params = {
    "type": "QR",
    "text": "https://example.com",
    "format": "png",
    "foreColor": "DarkBlue",
    "backColor": "LightYellow",
    "qrErrorLevel": "LevelH",
    "logo": read_logo_as_base64("logo.png")  # optional
}

مقادیر را طوری تنظیم کنید که با راهنمایی‌های برندینگ یا الزامات طراحی بصری شما مطابقت داشته باشد.

سوالاتی که ممکن است داشته باشید

  • چگونه می‌توانم کد QR سفارشی با Aspose.BarCode Python بدون نوشتن کد زیاد ایجاد کنم؟
    SDK کارهای سنگین را انتزاع می‌کند. با تنظیم چند پارامتر در دیکشنری params و فراخوانی get_barcode_generate، یک تصویر QR آماده‑به‑استفاده دریافت می‌کنید.

  • آیا می‌توان با استفاده از Aspose.BarCode SDK کد QR با لوگو را در یک پلتفرم سرورلس تولید کرد؟
    بله. این کتابخانه در هر محیط پایتون، از جمله AWS Lambda یا Azure Functions، کار می‌کند، به شرطی که زمان اجرا بتواند به https://api.aspose.cloud دسترسی داشته باشد.

  • اسکریپت پایتون برای تولید کد QR Aspose چه چیزی برمی‌گرداند؟
    get_barcode_generate متد بایت‌های تصویر خام را برمی‌گرداند که می‌توانید مستقیم به یک فایل بنویسید یا به یک پاسخ وب استریم کنید.

  • چگونه می‌توانم رنگ‌های کد QR را در Aspose.BarCode Python برای پالت برند خود سفارشی کنم؟
    از پارامترهای foreColor و backColor با هر نام رنگ HTML یا مقدار HEX که توسط API پشتیبانی می‌شود، استفاده کنید.

  • گزینه‌های مجوز چیست و چگونه می‌توانم یک مجوز موقت دریافت کنم؟
    مجوزهای کامل برای خرید از وب‌سایت Aspose در دسترس هستند. برای ارزیابی، می‌توانید یک مجوز موقت را از صفحه مجوز موقت درخواست کنید.

بیشتر بخوانید