יצירת קודי QR בזמן אמת היא חיונית לתשלומים ניידים, כרטיסי אירועים ומעקב מלאי. ה-Aspose.BarCode Cloud SDK for Python מאפשר ליצור קודי QR באיכות גבוהה ישירות מיישומי ה-Python שלך. במדריך זה נעבור על זרימת העבודה של קוד QR ב‑Aspose.BarCode cloud Python, מהגדרת האישורים ועד התאמת הצבעים והטמעת הלוגו. תלמדו גם כיצד ליצור במרוכז מספר קודים ולהשתמש בפקודות cURL שוות ערך לשילוב REST. ספריית קוד QR של Aspose.BarCode cloud Python תומכת גם בהוספת לוגואים והתאמת רמות תיקון השגיאות לסריקה אמינה.
לפני שאתה מתחיל: דרישות מקדימות והתקנה
לפני שתתחיל, ודא שיש לך את הדברים הבאים:
- 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 for Python
מדריך שלב‑אחר‑שלב זה מדגים כיצד לעבוד עם Aspose.BarCode cloud Python QR code 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 reference.
שלב 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 מרובים באצווה (אופציונלי)
בצע לולאה ברשימת טקסטים ושמות קבצים כדי ליצור כמה קודי 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 במצב אצווה עם הגדרות מותאמות
הסקריפט הבא מחבר את כל החלקים יחד ומדגים את תהליך יצירת קוד 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 code של Aspose.BarCode cloud 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 שתונח במרכז קוד ה‑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 מוכנה לשימוש. -
האם ניתן ליצור קוד QR עם לוגו באמצעות Aspose.BarCode SDK בפלטפורמה ללא שרת?
כן. הספרייה עובדת בכל סביבת Python, כולל AWS Lambda או Azure Functions, כל עוד זמן הריצה יכול לגשת ל-https://api.aspose.cloud. -
מה מחזירה הסקריפט פייתון ליצירת קוד QR של Aspose?
המתודהget_barcode_generateמחזירה את בתוני התמונה הגולמיים, שניתן לכתוב אותם ישירות לקובץ או להזרים לתגובה באינטרנט. -
איך אני מתאים את צבעי קוד QR ב‑Aspose.BarCode Python לפלטת המותג שלי?
השתמש בפרמטריםforeColorו‑backColorעם כל שם צבע HTML או ערך HEX הנתמך על‑ידי ה‑API. -
מהן אפשרויות הרישוי וכיצד ניתן לקבל רישיון זמני?
רישיונות מלאים זמינים לרכישה באתר Aspose. לצורך הערכה, ניתן לבקש רישיון זמני מדף רישיון זמני.