Генерация QR‑кодов «на лету» имеет решающее значение для мобильных платежей, билетов на мероприятия и отслеживания запасов. Aspose.BarCode Cloud SDK for Python позволяет создавать QR‑коды высокого качества непосредственно из ваших Python‑приложений. В этом руководстве мы пройдем весь рабочий процесс Aspose.BarCode cloud Python QR‑кода, от настройки учетных данных до настройки цветов и встраивания логотипов. Вы также узнаете, как пакетно генерировать несколько кодов и использовать эквивалентные команды cURL для интеграции через REST. Библиотека Aspose.BarCode cloud Python QR‑кода также поддерживает добавление логотипов и настройку уровней коррекции ошибок для надёжного сканирования.
Перед началом: Предварительные требования и установка
Прежде чем начать, убедитесь, что у вас есть следующее:
- 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.
Шаг 2: Определите параметры QR‑кода
Создайте словарь, который содержит параметры QR‑кода, такие как тип, текст, формат, цвета и уровень коррекции ошибок.
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: Сгенерировать и сохранить 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‑подход, вы можете использовать конечную точку 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. Для оценки вы можете запросить временную лицензию на странице страница временной лицензии.