إنشاء رموز QR في الوقت الفعلي أمر أساسي للمدفوعات المتنقلة، وتذاكر الفعاليات، وتتبع المخزون. يتيح لك Aspose.BarCode Cloud SDK for Python إنشاء رموز QR عالية الجودة مباشرةً من تطبيقات Python الخاصة بك. في هذا الدليل سنستعرض سير عمل Aspose.BarCode cloud Python QR code، بدءًا من إعداد الاعتمادات وحتى تخصيص الألوان وإدراج الشعارات. ستتعلم أيضًا كيفية إنشاء عدة رموز دفعةً واحدة واستخدام أوامر 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 مخصصة باستخدام Aspose.BarCode Cloud SDK for Python
هذا الدليل خطوة بخطوة يوضح كيفية العمل مع Aspose.BarCode cloud Python QR code API لإنشاء صور QR مخصصة بالكامل.
الخطوة 1: تحميل المستند المصدر وتعيين بيانات الاعتماد
أولاً، استورد الوحدات المطلوبة وأنشئ مثيل BarCodeApi كما هو موضح أعلاه. هذا يُجهّز المكتبة للتواصل مع خدمة Aspose السحابية.
الخطوة 2: تعريف معلمات رمز الاستجابة السريعة
إنشاء قاموس يحتوي على خيارات رمز الاستجابة السريعة مثل النوع والنص والتنسيق والألوان ومستوى تصحيح الأخطاء.
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: إنشاء وحفظ رمز الاستجابة السريعة
استدعِ طريقة 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 نقي، يمكنك استخدام نقطة النهاية Aspose.BarCode cloud Python QR code مع أوامر 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 تت iterates over a list of texts وتستدعي طلب GET المذكور أعلاه لكل إدخال، مع حفظ النتائج بأسماء ملفات مميزة.
للحصول على تفاصيل كاملة عن واجهة برمجة التطبيقات، راجع الوثائق الرسمية لواجهة برمجة التطبيقات.
خيارات التخصيص: الألوان، الشعار، وتصحيح الأخطاء
يتيح 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. للتقييم، يمكنك طلب ترخيص مؤقت من صفحة صفحة الترخيص المؤقت.