Adicionar logotipos aos códigos QR melhora a marca, a estética e a confiança. Personalize, envolva e construa credibilidade. Códigos QR personalizados com logotipos criam experiências de marca visualmente atraentes, reconhecíveis e confiáveis. Nesta postagem do blog, exploraremos como gerar um código QR com um logotipo personalizado em C# usando a API REST do gerador de código QR. Utilizaremos o GroupDocs.Signature Cloud SDK para .NET para obter essa funcionalidade. Então, vamos aprender como gerar códigos QR com um logotipo usando C#.
Esboço das etapas:
- Etapa 1: configurar o SDK do criador de código QR C#
- Etapa 2: inicializar o cliente API
- Etapa 3: Carregar o Documento
- Etapa 4: Adicionar código QR com logotipo
- Etapa 5: Baixar arquivo de saída
- Perguntas frequentes
Etapa 1: configurar o SDK do gerador de código QR C#
Para começar, certifique-se de ter o GroupDocs.Signature Cloud SDK for .NET instalado em seu projeto. Você pode instalar GroupDocs.Signature Cloud SDK for .NET em seu projeto a partir do gerenciador de pacotes NuGet ou usando o seguinte comando na CLI do .NET:
dotnet add package GroupDocs.Signature-Cloud --version 23.4.0
Etapa 2: inicializar o cliente API
Para inicializar o cliente API, obtenha seu ID do cliente e Segredo do cliente no painel e adicione o código conforme mostrado abaixo:
| //Get clientId & clientSecret from https://dashboard.groupdocs.cloud (free registration is required). | |
| string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"; | |
| string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"; | |
| string myStorage = "test-internal-storage"; | |
| var configuration = new Configuration(clientId, clientSecret); | |
| configuration.ApiBaseUrl = "https://api.groupdocs.cloud"; |
Passo 3: Carregando o Documento
Antes de gerar o código QR com logotipo, você precisa fazer upload do logotipo e do documento ao qual deseja adicionar o código QR. Carregue o documento e o logotipo para o armazenamento em nuvem usando qualquer um dos seguintes métodos:
- Usando o painel.
- Carregue todos os arquivos um por um usando Upload File API do navegador.
- Faça upload programaticamente usando o exemplo de código abaixo:
| // Create necessary API instances | |
| var storageApi = new StorageApi(configuration); | |
| var fileApi = new FileApi(configuration); | |
| var path = @"H:\groupdocs-cloud-data"; | |
| var files = Directory.GetFiles(path, "*.pdf", SearchOption.AllDirectories); | |
| foreach (var file in files) | |
| { | |
| var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar); | |
| var response = storageApi.ObjectExists(new ObjectExistsRequest(relativeFilePath, myStorage)); | |
| if (response.Exists != null && !response.Exists.Value) | |
| { | |
| var fileStream = File.Open(file, FileMode.Open); | |
| fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, myStorage)); | |
| fileStream.Close(); | |
| } | |
| } |
Como resultado, os arquivos enviados estarão disponíveis na seção de arquivos do seu painel na nuvem.
Etapa 4: gerar um código QR com logotipo usando C#
Aqui estão as etapas e o código de exemplo que mostram como gerar um código QR com um logotipo em C# usando a API REST do gerador de código QR.
- Primeiro, crie um objeto de configuração com suas credenciais de API.
- Em seguida, instancie a classe SignApi para acessar a funcionalidade de assinatura.
- Em seguida, defina as opções do QR Code para a assinatura, incluindo cor de fundo, dimensões, alinhamento, posição e caminho do arquivo do logotipo.
- Em seguida, especifique as configurações de assinatura, incluindo o caminho do arquivo do documento e o caminho do arquivo de saída.
- Em seguida, crie uma solicitação de assinatura usando as configurações de assinatura especificadas.
- Por fim, faça a solicitação de assinatura utilizando o método CreateSignatures e acesse a resposta para recuperar informações sobre o documento assinado.
O exemplo de código a seguir mostra como criar um código QR com um logotipo personalizado em C# usando a API REST do criador de código QR.
| var configuration = new GroupDocs.Signature.Cloud.Sdk.Client.Configuration("xxxxxx-xxxxxx-xxxxxxx-xxxxxxxx", "xxxxxxxxxxxxxxxxxxxxxxxx"); | |
| var apiInstance = new GroupDocs.Signature.Cloud.Sdk.Api.SignApi(configuration); | |
| //set QR Code options | |
| var signQRCodeOptions = new GroupDocs.Signature.Cloud.Sdk.Model.SignQRCodeOptions() | |
| { | |
| BackgroundColor = new GroupDocs.Signature.Cloud.Sdk.Model.Color() { Web = "#fcfcfc" }, | |
| Width = 100, | |
| Height = 80, | |
| HorizontalAlignment = GroupDocs.Signature.Cloud.Sdk.Model.SignQRCodeOptions.HorizontalAlignmentEnum.Right, | |
| VerticalAlignment = GroupDocs.Signature.Cloud.Sdk.Model.SignQRCodeOptions.VerticalAlignmentEnum.Center, | |
| Left = 10, | |
| Top = 100, | |
| LocationMeasureType = GroupDocs.Signature.Cloud.Sdk.Model.SignQRCodeOptions.LocationMeasureTypeEnum.Pixels, | |
| Margin = new GroupDocs.Signature.Cloud.Sdk.Model.Padding { Left = 10, Right = 10, Bottom = 10, Top = 10 }, | |
| MarginMeasureType = GroupDocs.Signature.Cloud.Sdk.Model.SignQRCodeOptions.MarginMeasureTypeEnum.Pixels, | |
| LogoFilePath = "csharp-testing/logo.jpg" | |
| }; | |
| // specify settings for creating request | |
| var settings = new SignSettings(); | |
| settings.FileInfo = new GroupDocs.Signature.Cloud.Sdk.Model.FileInfo | |
| { | |
| FilePath = "csharp-testing/sample.pdf" | |
| }; | |
| settings.Options.Add(signQRCodeOptions); | |
| settings.SaveOptions.OutputFilePath = "csharp-testing/out_sample.pdf"; | |
| // create signature making request | |
| var request = new GroupDocs.Signature.Cloud.Sdk.Model.Requests.CreateSignaturesRequest() | |
| { | |
| signSettings = settings | |
| }; | |
| var response = apiInstance.CreateSignatures(request); | |
| Debug.Print("FleName: " + response.FileInfo.FilePath); |
Etapa 5: Baixe o arquivo resultante
O código fornecido na etapa anterior salva o arquivo resultante na nuvem. Para baixá-lo, você pode usar o seguinte trecho de código.
| // initialize api | |
| var fileApi = new FileApi(configuration); | |
| // create download file request | |
| var downloadRequest = new DownloadFileRequest("csharp-testing/merged-file.pdf", myStorage); | |
| // download file | |
| Stream downloadResponse = fileApi.DownloadFile(downloadRequest); | |
| // save file in working directory | |
| using (var fileStream = System.IO.File.Create("H:\\groupdocs-cloud-data\\merged-file.pdf")) | |
| { | |
| downloadResponse.Seek(0, SeekOrigin.Begin); | |
| downloadResponse.CopyTo(fileStream); | |
| } | |
| Console.WriteLine("File downloaded successfully."); |
Perguntas frequentes:
Posso usar um formato de arquivo de imagem diferente de JPG para o logotipo?
Sim, a API Rest do gerador de código QR C# oferece suporte a vários formatos de arquivo de imagem, como PNG, JPEG, GIF e BMP para a imagem do logotipo.
Posso gerar código QR a partir de string em C#?
Sim, você pode ver um exemplo C# gerar código QR a partir de string.
Qual é o nível de correção de erros e a versão do código QR?
O nível de correção de erros determina a quantidade de redundância no código QR, afetando sua legibilidade e capacidade de correção de erros. A versão determina o tamanho e a capacidade de dados do código QR. Você pode escolher os valores apropriados com base em seus requisitos.
Posso personalizar a aparência do código QR, como alterar as cores?
Sim, a API REST do gerador de código QR C# oferece opções adicionais para personalizar a aparência do código QR, incluindo cor de primeiro plano, cor de fundo e cor da borda.
O GroupDocs.Signature Cloud SDK for .NET é um serviço pago?
Sim, GroupDocs.Signature Cloud oferece planos gratuitos e pagos. Você pode visitar o website para obter mais informações sobre preços e recursos disponíveis.
Conclusão
Nesta postagem do blog, aprendemos como gerar códigos QR com logotipos em C# usando a API QR Code Generator Rest. Ao adicionar um logotipo personalizado, você pode melhorar o apelo visual e o reconhecimento da marca dos seus códigos QR.
O GroupDocs.Signature Cloud SDK para .NET simplifica o processo e oferece várias opções de personalização. Sinta-se à vontade para explorar a documentação e experimentar diferentes configurações para gerar código QR em C# que se alinhe aos requisitos de sua marca.
Além disso, você pode ver uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. O código-fonte completo do SDK C# está disponível gratuitamente no Github.
Por fim, continuamos escrevendo novos artigos de blog em diferentes formatos de arquivo e analisando-os usando a API REST. Portanto, entre em contato para obter as últimas atualizações. Boa codificação!
Gerador de código QR online gratuito
Para gerar código QR on-line gratuitamente. Experimente um aplicativo gerador de código QR on-line para criar códigos QR. Este aplicativo criador de código QR foi desenvolvido usando a biblioteca de assinaturas C# mencionada acima.
Faça uma pergunta
Caso você tenha alguma dúvida ou confusão sobre o gerador de código QR, não hesite em nos contatar através do nosso fórum.
Veja também
Aqui estão alguns artigos relacionados que podem ser úteis: