Генерація QR‑кодів у режимі реального часу є важливою для мобільних платежів, квитків на події та відстеження інвентарю. Aspose.BarCode Cloud SDK for Python дозволяє створювати високоякісні QR‑коди безпосередньо з ваших Python‑додатків. У цьому посібнику ми розглянемо Aspose.BarCode cloud Python QR code workflow, починаючи з налаштування облікових даних і закінчуючи налаштуванням кольорів та вбудовуванням логотипів. Ви також дізнаєтесь, як пакетно генерувати кілька кодів і використовувати еквівалентні команди cURL для інтеграції REST. Aspose.BarCode cloud Python QR code library також підтримує додавання логотипів та налаштування рівнів корекції помилок для надійного сканування.
Перед початком: вимоги та встановлення
Перш ніж розпочати, переконайтеся, що у вас є наступне:
- 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 cloud service.
Крок 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)
Це ілюструє пакетне створення QR‑кодів Python Aspose у стислому циклі.
Повний приклад коду: пакетна генерація QR‑кодів з користувацькими налаштуваннями
Наступний скрипт збирає всі частини разом і демонструє процес генерації QR‑коду в хмарі Aspose.BarCode за допомогою 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, який перебирає список текстів і викликає вищезазначений 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. -
Що повертає python-скрипт для генерації QR-коду Aspose?
Методget_barcode_generateповертає необроблені байти зображення, які можна безпосередньо записати у файл або передати у веб‑відповідь. -
Як налаштувати кольори QR‑коду Aspose.BarCode Python під палітру мого бренду?
Використовуйте параметриforeColorіbackColorз будь‑яким назвою кольору HTML або HEX‑значенням, підтримуваним API. -
Які варіанти ліцензування і як я можу отримати тимчасову ліцензію?
Повні ліцензії доступні для придбання на веб‑сайті Aspose. Для оцінки ви можете запросити тимчасову ліцензію на сторінці тимчасової ліцензії.