การสร้าง QR code อย่างรวดเร็วเป็นสิ่งสำคัญสำหรับการชำระเงินผ่านมือถือ, ตั๋วงานอีเวนท์, และการติดตามสินค้าคงคลัง. The Aspose.BarCode Cloud SDK for Python helps you create high‑quality QR codes directly from your Python applications. ในคู่มือนี้ เราจะอธิบายขั้นตอนการทำงานของ Aspose.BarCode cloud Python QR code workflow ตั้งแต่การตั้งค่าข้อมูลประจำตัวจนถึงการปรับแต่งสีและการฝังโลโก้. คุณจะได้เรียนรู้วิธีการสร้างหลายโค้ดพร้อมกันและใช้คำสั่ง cURL ที่เทียบเท่าสำหรับการรวมระบบ REST. ไลบรารี Aspose.BarCode cloud Python QR code ยังรองรับการเพิ่มโลโก้และการปรับระดับการแก้ไขข้อผิดพลาดเพื่อการสแกนที่แม่นยำ.

ก่อนเริ่ม: ข้อกำหนดเบื้องต้นและการติดตั้ง

ก่อนที่คุณจะเริ่ม, โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้:

  • 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 Code แบบกำหนดเองด้วย Aspose.BarCode Cloud SDK for Python

คู่มือแบบขั้นตอนต่อขั้นตอนนี้แสดงวิธีการทำงานกับ Aspose.BarCode cloud Python QR code API เพื่อสร้างภาพ QR ที่ปรับแต่งได้อย่างเต็มที่.

ขั้นตอนที่ 1: โหลดเอกสารต้นฉบับและตั้งค่าข้อมูลรับรอง

ขั้นแรก ให้นำเข้าโมดูลที่จำเป็นและสร้างอินสแตนซ์ BarCodeApi ตามที่แสดงด้านบน ซึ่งจะเตรียมไลบรารีให้สื่อสารกับบริการคลาวด์ของ Aspose.

ขั้นตอนที่ 2: กำหนดพารามิเตอร์ QR Code

สร้างพจนานุกรมที่เก็บตัวเลือกของ QR code เช่น ประเภท, ข้อความ, รูปแบบ, สี, และระดับการแก้ไขข้อผิดพลาด.

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 code พร้อมโลโก้ Aspose.BarCode sdk.

ขั้นตอนที่ 4: สร้างและบันทึก QR Code

เรียกเมธอด 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 Code หลายรายการเป็นชุด (ไม่บังคับ)

วนลูปผ่านรายการข้อความและชื่อไฟล์เพื่อสร้าง QR code หลายรายการในหนึ่งการทำงาน

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 Code เป็นชุดพร้อมการตั้งค่าที่กำหนดเอง

สคริปต์ต่อไปนี้รวมส่วนต่าง ๆ เข้าด้วยกันและแสดงกระบวนการสร้าง QR code ของ 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 Code ผ่าน REST API ด้วย cURL

หากคุณต้องการใช้วิธี REST แบบบริสุทธิ์ คุณสามารถใช้ Aspose.BarCode cloud Python QR code endpoint พร้อมคำสั่ง cURL เพื่อให้ได้ผลลัพธ์เดียวกัน

1. รับ Access Token

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 Code

แทนที่ 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 code.

  • foreColor - ตั้งค่าสีพื้นหน้า (โมดูล) ตัวอย่าง: "DarkBlue".
  • backColor - ตั้งค่าสีพื้นหลัง ตัวอย่าง: "LightYellow".
  • qrErrorLevel - ควบคุมการแก้ไขข้อผิดพลาด ตัวเลือกคือ LevelL, LevelM, LevelQ, LevelH. ระดับที่สูงขึ้นจะเพิ่มความทนทานแต่จะลดความจุของข้อมูล
  • logo - รูปภาพที่เข้ารหัสเป็น Base64 ซึ่งจะถูกวางที่ศูนย์กลางของ QR code.

ด้านล่างเป็นส่วนย่อยที่แสดงวิธีการประกอบตัวเลือกเหล่านี้ในพจนานุกรมคำขอ:

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 ที่พร้อมใช้งาน

  • สามารถสร้าง QR code พร้อมโลโก้โดยใช้ Aspose.BarCode SDK บนแพลตฟอร์ม serverless ได้หรือไม่?
    ใช่. ไลบรารีทำงานได้ในสภาพแวดล้อม Python ใด ๆ รวมถึง AWS Lambda หรือ Azure Functions ตราบใดที่ runtime สามารถเข้าถึง https://api.aspose.cloud.

  • What does the python script for QR code generation Aspose return?
    เมธอด get_barcode_generate จะคืนค่าเป็นไบต์ของรูปภาพดิบ ซึ่งคุณสามารถเขียนโดยตรงไปยังไฟล์หรือสตรีมไปยังการตอบสนองเว็บได้

  • ฉันจะปรับแต่งสีของ QR code ใน Aspose.BarCode Python ให้ตรงกับพาเลตต์ของแบรนด์ของฉันได้อย่างไร?
    ใช้พารามิเตอร์ foreColor และ backColor กับชื่อสี HTML หรือค่า HEX ที่ API รองรับ

  • ตัวเลือกการให้สิทธิ์ใช้งานคืออะไรและฉันจะขอรับใบอนุญาตชั่วคราวได้อย่างไร?
    ใบอนุญาตเต็มสามารถซื้อได้จากเว็บไซต์ Aspose สำหรับการประเมินผล คุณสามารถขอรับใบอนุญาตชั่วคราวได้จาก temporary license page.

Read More