> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/android/standalone-modules/document-detector/builder/messages.md). # Configurações de mensagens Para usar, basta instanciar um **`MessageSettings`** objeto e usar os métodos conforme necessário para personalização. | Método | Descrição | Valor Padrão | | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | `.setPopupDocumentSubtitleMessage(message: Int)` | Mensagem de legenda no pop-up que mostra a ilustração do documento. | "Coloque o documento sobre uma mesa, centralize-o na moldura e segure para capturar." | | `.setFitTheDocumentMessage(message: Int)` | Mensagem que solicita ao usuário que encaixe o documento na moldura. | "Encaixe o documento na moldura." | | `.setHoldItMessage(message: Int)` | Mensagem exibida durante o processo de captura. | "Mantenha-o firme." | | `.setVerifyingQualityMessage(message: Int)` | Mensagem exibida durante a solicitação de verificação de qualidade. | "Verificando documento..." | | `.setLowQualityDocumentMessage(message: Int)` | Mensagem exibida quando a captura do documento falha devido à baixa qualidade. | "Não foi possível ler as informações. Tente novamente." | | `.setUploadingImageMessage(message: Int)` | Mensagem exibida ao salvar a imagem capturada no servidor. | "Enviando imagem..." | | `.setShowOpenDocumentErrorMessage(show: Boolean, message: Int)` | Mensagem exibida se um documento aberto for detectado. | "Feche o documento e tente novamente." | | `.setWaitMessage(show: Boolean, message: Int)` | Mensagem exibida ao iniciar a câmera. | "Por favor, aguarde..." | | `.setSensorLuminosityMessage(message: Int)` | Mensagem exibida quando o nível de brilho está muito baixo. | "A área está muito escura." | | `.setSensorOrientationMessage(message: Int)` | Mensagem exibida quando o limite de orientação não é atingido. | "Aponte a câmera para baixo." | | `.setSensorStabilityMessage(message: Int)` | Mensagem exibida quando o dispositivo não está estável o suficiente. | "Segure o dispositivo com firmeza." | | `.setWrongDocumentTypeMessageResourceId(message: Int)` | Mensagem exibida quando o tipo de documento está incorreto. Use %1$s para o documento esperado. | "Este documento não é %1$s." | | `.setPositiveButtonMessage(message: Int)` | Personaliza o texto do botão de confirmação. | "OK, entendi." | | `.setUploadedImageIsTooLargeTitle(message: Int)` | Título do pop-up de envio quando o arquivo excede o tamanho máximo. | "Tamanho do arquivo excedido." | | `.setUploadedImageIsTooLargeMessage(message: Int)` | Mensagem do pop-up de envio quando o arquivo excede o tamanho máximo. Use %1$s para o tamanho máximo. | "O arquivo excede o tamanho máximo de %1$d MB. Envie um arquivo menor." | | `.setUploadedImageHasInvalidFormatTitle(message: Int)` | Título do pop-up de envio quando o formato do arquivo é inválido. | "Formato inválido." | | `.setUploadedImageNotSupportedFormatMessage(message: Int)` | Mensagem para formatos de arquivo não suportados no pop-up de envio. | "Formato de arquivo não suportado. Use JPG, PNG ou PDF." | | `.setUploadedImageGenericErrorTitle(message: Int)` | Título de erro genérico para o pop-up de envio. | "Algo deu errado." | | `.setUploadedImageWrongMessage(message: Int)` | Mensagem para um documento inesperado no pop-up de envio. | "Este não é o documento esperado. Envie o correto." | | `.setUploadedImageLowQualityTitle(message: Int)` | Título do pop-up de envio quando a qualidade da imagem é baixa. | "Imagem de baixa qualidade." | | `.setUploadedImageLowQualityMessage(message: Int)` | Mensagem para imagens de baixa qualidade no pop-up de envio. | "A qualidade da imagem está muito baixa. Envie uma melhor." | | `.setUploadPopupLoadingMessage(message: Int)` | Mensagem exibida durante o envio do arquivo no pop-up. | "Enviando documento..." | | `.setPredictorScanDocumentMessage(resId: Int)` | Mensagem que solicita ao usuário que digitalize um documento. | "Digitalize um documento." | | `.setPredictorGetCloserMessage(resId: Int)` | Mensagem que pede ao usuário para se aproximar do documento. | "Aproxime-se do documento." | | `.setPredictorCentralizeMessage(resId: Int)` | Mensagem que pede ao usuário para centralizar o documento. | "Centralize o documento." | | `.setPredictorMoveAwayMessage(resId: Int)` | Mensagem que pede ao usuário para se afastar do documento. | "Afaste-se mais do documento." | | `.setPredictorAlignDocumentMessage(resId: Int)` | Mensagem que pede ao usuário para alinhar o documento. | "Alinhe o documento." | | `.setPredictorTurnDocumentMessage(resId: Int)` | Mensagem que pede ao usuário para girar o documento em 90 graus. | "Gire o documento ⤵️." | | `.setPredictorCapturedMessage(resId: Int)` | Mensagem que confirma que o documento foi capturado. | "Documento capturado." | | `.setUnsupportedDocumentMessage(message: Int)` | Mensagem para documentos não suportados. | "Este documento não é suportado." | | `.setDocumentNotFoundMessage(message: Int)` | Mensagem quando nenhum documento é detectado. | "Nenhum documento encontrado." | ### Exemplo ```kotlin val messageSettings = MessageSetings() .setFitTheDocumentMessage(R.string.example_resource) .setHoldItMessage(R.string.example_resource); ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-sdk/caf-sdk-pt-br/android/standalone-modules/document-detector/builder/messages.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.