Skip to content

Commit

Permalink
Merge pull request #2508 from mercadopago/feature/rdc-migration
Browse files Browse the repository at this point in the history
feature/rdc-migration
  • Loading branch information
hgaldino authored Dec 13, 2024
2 parents c398bb7 + fd17243 commit 8f0e808
Show file tree
Hide file tree
Showing 81 changed files with 2,319 additions and 869 deletions.
2 changes: 1 addition & 1 deletion guides/mp-point-main-apps/access-settings.en.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Access settings
# Set bluetooth

Use the `launch` method of the `BluetoothUiSettings` class to start with the bluetooth settings on Mercado Pago. That component provides several features, like activating and deactivating, searching for devices, and pairing and unpairing, among others. Check how to access it.

Expand Down
2 changes: 1 addition & 1 deletion guides/mp-point-main-apps/access-settings.es.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Acceder a la configuración
# Configurar bluetooth

Usa el método `launch` de la clase `BluetoothUiSettings` para iniciar la actividad de configuración de bluetooth de Mercado Pago. Este componente ofrece diversas funcionalidades, cómo activar y desactivar, buscar dispositivos, emparejar y desemparejar, entre otros. Consulta cómo acceder.

Expand Down
2 changes: 1 addition & 1 deletion guides/mp-point-main-apps/access-settings.pt.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Acessar configurações
# Configurar o bluetooth

Use o método `launch` da classe `BluetoothUiSettings` para iniciar a atividade de configurações de bluetooth do Mercado Pago. Esse componente proporciona diversas funcionalidades, como ativar e desativar, buscar dispositivos, emparelhar e desemparelhar, entre outras. Confira como acessá-lo.

Expand Down
66 changes: 66 additions & 0 deletions guides/mp-point-main-apps/camscanner-callback.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Launch Camera via Callback

This mode centralizes the flow of launching the scanner camera in a single method, `launchScanner`, which, along with the use of callbacks for handling responses, simplifies the implementation and reading of codes.

For this implementation, you will need to differentiate which type of code you want to scan using the `ScanType` class, and provide the callback to be invoked with the result of the operation, as shown in the example below and in the descriptions of the fields to be completed.

[[[
```kotlin
val cameraScanner = MPManager.cameraScanner
/**
* launch camera for QR scanner code
**/
cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_QR) { response ->
response
.doIfSuccess { result -> // Handling the successful scanner result result.message }

.doIfError { error -> // Handling the error resulting from the scanner error.message.orEmpty() }

}

/**
* launch camera for Barcode scanner
**/

cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_BARCODE) { response ->
response
.doIfSuccess { result -> // Handling the successful scanner result result.message }

.doIfError { error -> // Handling the error resulting from the scanner error.message.orEmpty() }

}
```
```java
final CameraScanner cameraScanner = MPManager.INSTANCE.getCameraScanner();
final Function<MPResponse<CameraScannerResponse>, Unit> callback = new Function<MPResponse<CameraScannerResponse>, Unit>() {
@Override
public Unit apply(MPResponse<CameraScannerResponse> response) {
if (response.getStatus() == ResponseStatus.SUCCESS) {

// Handle the successful response
CameraScannerResponse cameraScannerResponse = response.getData();

String result = cameraScannerResponse.getMessage();
// ... Do something with the result
} else {

// Handle the error in the response
String errorMessage = response.getError();
// ... Do something with the error
}
return Unit.INSTANCE;
}
};

/**
* Launch the camera scanner for QR or Barcode with the callback: ScanType.CAMERA_SCANNER_QR - ScanType.CAMERA_SCANNER_BARCODE
*/

cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_QR, callback);
```
]]]

| Field | Description |
|---|---|
|**ScanType**| Class that contains the types of codes to be read by the camera. Possible values are:<br><br> - `CAMERA_SCANNER_QR`: represents the reading of QR codes.<br><br> - `CAMERA_SCANNER_BARCODE`: represents the reading of barcodes.|
|**callback (MPResponse<CameraScannerResponse>) -> Unit**| Callback to be invoked with the result of the scanner operation. Receives an `MPResponse` object with a `CameraScannerResponse`.|
66 changes: 66 additions & 0 deletions guides/mp-point-main-apps/camscanner-callback.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Lanzar cámara por callback

Esta modalidad centraliza el flujo de lanzamiento de la cámara scanner en un sólo método, `launchScanner`, que junto con la utilización de callbacks para el manejo de respuestas, simplifica el proceso de implementación y lectura de códigos.

Para esta implementación, deberás diferenciar qué tipo de código deseas escanear mediante la clase `ScanType`, y proporcionar el callback a ser invocado con el resultado de la operación, tal como se muestra en el ejemplo a continuación y en las descripciones de los campos a completar.

[[[
```kotlin
val cameraScanner = MPManager.cameraScanner
/**
* launch camera for scanner code QR
**/
cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_QR) { response ->
response
.doIfSuccess { result -> // Manejo del resultado success del scanner result.message }

.doIfError { error -> // Manejo del error que resulte del scanner error.message.orEmpty() }

}

/**
* launch camera for scanner Bar code
**/

cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_BARCODE) { response ->
response
.doIfSuccess { result -> // Manejo del resultado success del scanner result.message }

.doIfError { error -> // Manejo del error que resulte del scanner error.message.orEmpty() }

}
```
```java
final CameraScanner cameraScanner = MPManager.INSTANCE.getCameraScanner();
final Function<MPResponse<CameraScannerResponse>, Unit> callback = new Function<MPResponse<CameraScannerResponse>, Unit>() {
@Override
public Unit apply(MPResponse<CameraScannerResponse> response) {
if (response.getStatus() == ResponseStatus.SUCCESS) {

// Manejar la respuesta exitosa
CameraScannerResponse cameraScannerResponse = response.getData();

String result = cameraScannerResponse.getMessage();
// ... Hacer algo con el resultado
} else {

// Manejar el error en la respuesta
String errorMessage = response.getError();
// ... Hacer algo con el error
}
return Unit.INSTANCE;
}
};

/**
* Lanzar el escáner de cámara QR o Barra con el callback: ScanType.CAMERA_SCANNER_QR - ScanType.CAMERA_SCANNER_BARCODE
*/

cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_QR, callback);
```
]]]

| Campo | Descripción |
|---|---|
|**ScanType**| Clase que contiene los tipos de código a ser leídos por la cámara. Los valores posibles son:<br><br> - `CAMERA_SCANNER_QR`: representa la lectura de códigos QR.<br><br> - `CAMERA_SCANNER_BARCODE`: representa la lectura de códigos de barras.|
|**callback (MPResponse<CameraScannerResponse>) -> Unit**| Callback a ser invocado con el resultado de la operación del escáner. Recibe un objeto `MPResponse` con un `CameraScannerResponse`.|
66 changes: 66 additions & 0 deletions guides/mp-point-main-apps/camscanner-callback.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Iniciar câmera via callback

Esta modalidade centraliza o fluxo de lançamento da câmera scanner em um único método, `launchScanner`, que junto com a utilização de callbacks para o manuseio de respostas, simplifica o processo de implementação e leitura de códigos.

Para essa implementação, você deverá diferenciar qual tipo de código deseja escanear através da classe `ScanType`, e fornecer o callback a ser chamado com o resultado da operação, como mostrado no exemplo abaixo e nas descrições dos campos a serem preenchidos.

[[[
```kotlin
val cameraScanner = MPManager.cameraScanner
/**
* iniciar câmera para escanear código QR
**/
cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_QR) { response ->
response
.doIfSuccess { result -> // Manuseio do resultado de sucesso do scanner result.message }

.doIfError { error -> // Manuseio do erro resultante do scanner error.message.orEmpty() }

}

/**
* iniciar câmera para escanear código de barras
**/

cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_BARCODE) { response ->
response
.doIfSuccess { result -> // Manuseio do resultado de sucesso do scanner result.message }

.doIfError { error -> // Manuseio do erro resultante do scanner error.message.orEmpty() }

}
```
```java
final CameraScanner cameraScanner = MPManager.INSTANCE.getCameraScanner();
final Function<MPResponse<CameraScannerResponse>, Unit> callback = new Function<MPResponse<CameraScannerResponse>, Unit>() {
@Override
public Unit apply(MPResponse<CameraScannerResponse> response) {
if (response.getStatus() == ResponseStatus.SUCCESS) {

// Manusear a resposta bem-sucedida
CameraScannerResponse cameraScannerResponse = response.getData();

String result = cameraScannerResponse.getMessage();
// ... Fazer algo com o resultado
} else {

// Manusear o erro na resposta
String errorMessage = response.getError();
// ... Fazer algo com o erro
}
return Unit.INSTANCE;
}
};

/**
* Iniciar o escâner de câmera QR ou Barra com o callback: ScanType.CAMERA_SCANNER_QR - ScanType.CAMERA_SCANNER_BARCODE
*/

cameraScanner.launchScanner(ScanType.CAMERA_SCANNER_QR, callback);
```
]]]

| Campo | Descrição |
|---|---|
|**ScanType**| Classe que contém os tipos de código a serem lidos pela câmera. Os valores possíveis são:<br><br> - `CAMERA_SCANNER_QR`: representa a leitura de códigos QR.<br><br> - `CAMERA_SCANNER_BARCODE`: representa a leitura de códigos de barras.|
|**callback (MPResponse<CameraScannerResponse>) -> Unit**| Callback a ser invocado com o resultado da operação do escâner. Recebe um objeto `MPResponse` com um `CameraScannerResponse`.|
Original file line number Diff line number Diff line change
@@ -1,14 +1,23 @@
# Scan barcodes and QR codes
# Legacy Method for launching the camera

Below you will find information on how to start and manage the [Point Smart](/developers/pt/docs/mp-point/landing) scanner for reading **barcodes and QR codes**.
The `initBarcodeScanner` function of the `CameraScanner` class in our SDK is used to invoke the code reading functionality found in the Point Smart device. In addition, an extra function must be implemented in the activity that uses it to handle the reading response.

## Barcode
> WARNING
>
> Important
>
> This method to launch the camera scanner is considered legacy. We recommend updating your integration to the [Callback method](/developers/en/docs/main-apps/camscanner/callback) for a simplified implementation.
To begin reading QR codes of the [Point Smart](/developers/en/docs/mp-point/landing), use the `initBarcodeScanner` feature of the `CameraScanner` class.
Check how to initiate the reading of QR codes and barcodes, and how to handle the responses below.

This process uses a camera request through `startActivityForResult`, and the method `onActivityResult` must be implemented in the activity to handle the reading response.

Check the example below:
## Barcodes

To start reading barcodes codes with the Point Smart, begin by using the `initBarcodeScanner` function of the `CameraScanner` class.

This process makes a camera call through `startActivityForResult`, so the `onActivityResult` method allows you to manage the reading response.

For its implementation, see the example below.

[[[
```kotlin
Expand All @@ -23,11 +32,11 @@ cameraScanner.initBarcodeScanner(this);

## QR code

To begin reading QR codes of the [Point Smart](/developers/en/docs/mp-point/landing), use the `initQRCodeScanner` feature of the `CameraScanner` class.
To start reading QR codes with the Point Smart, begin by using the `initBarcodeScanner` function of the `CameraScanner` class.

This process uses a camera request through `startActivityForResult`, and the method `onActivityResult` must be implemented in the activity to handle the reading response.
This process makes a camera call through `startActivityForResult`, so the `onActivityResult` method allows you to manage the reading response.

Check the example below:
For its implementation, see the example below.

[[[
```kotlin
Expand Down
Original file line number Diff line number Diff line change
@@ -1,14 +1,23 @@
# Escanear códigos de barras y QR
# Método legacy para lanzar cámara

La función `initBarcodeScanner` de la clase `CameraScanner` en nuestro SDK se utiliza para invocar la funcionalidad de lectura de códigos que se encuentra en el dispositivo Point Smart. Además, debe implementarse una función adicional en la actividad que lo utiliza para manipular la respuesta de lectura.

> WARNING
>
> Importante
>
> Este método para lanzar la cámara scanner es considerado _legacy_. Recomendamos actualizar tu integración al [método Callback](/developers/es/docs/main-apps/camscanner/callback) para contar con una implementación simplificada.
Consulta cómo iniciar la lectura de códigos QR y de barras, y cómo manejar las respuestas, a continuación.

A continuación, encontrará información sobre cómo iniciar y gestionar el escáner de [Point Smart](/developers/pt/docs/mp-point/landing) para la lectura de **códigos de barras y QR**.

## Código de barras

Para iniciar la lectura de códigos QR del [Point Smart](/developers/es/docs/mp-point/landing), usa la función `initBarcodeScanner` de la clase `CameraScanner`.
Para iniciar la lectura de códigos de barras del Point Smart, comienza por utilizar la función `initBarcodeScanner` de la clase `CameraScanner`.

Este proceso usa un llamado de cámara a través de `startActivityForResult`, de modo que el método `onActivityResult` se debe implementar en la actividad para manipular la respuesta de lectura.
Este proceso usa un llamado de cámara a través de `startActivityForResult`, de modo que el método `onActivityResult`  permita gestionar la respuesta de lectura.

Consulta el ejemplo a continuación.
Para su implementación, consulta el ejemplo a continuación.

[[[
```kotlin
Expand All @@ -23,11 +32,11 @@ cameraScanner.initBarcodeScanner(this);

## Código QR

Para iniciar la lectura de códigos QR del [Point Smart](/developers/es/docs/mp-point/landing), usa la función `initQRCodeScanner` de la clase `CameraScanner`.
Para iniciar la lectura de códigos QR del Point Smart, comienza por utilizar la función `initBarcodeScanner` de la clase `CameraScanner`.

Este proceso usa un llamado de cámara a través de `startActivityForResult`, de modo que el método `onActivityResult` se debe implementar en la actividad para manipular la respuesta de lectura.
Este proceso usa un llamado de cámara a través de `startActivityForResult`, de modo que el método `onActivityResult`  permita gestionar la respuesta de lectura.

Consulta el ejemplo a continuación.
Para su implementación, consulta el ejemplo a continuación.

[[[
```kotlin
Expand All @@ -44,11 +53,9 @@ cameraScanner.initQRCodeScanner(this);

Para gestionar la respuesta de una actividad de escaneo de **código QR** o de **código de barras**, usa la función `handleQrResponse` de la clase `CameraScanner` en el método `onActivityResult`.

Esta función procesa el resultado del escáner desde la cámara, validando la respuesta e invocando el callback apropiado según el resultado. Recibe un objeto `MPResponse` con un `[CameraScannerResponse]`, representando la respuesta de lectura.

Este método simplifica el proceso de manejo de respuestas del escáner de QR o código de barra en el método `onActivityResult`, procesando el resultado del escáner desde la cámara, validando la respuesta e invocando el _callback_ apropiado según el resultado.
Esta función procesa el resultado del scanner desde la cámara, validando la respuesta e invocando el callback apropiado según el resultado. Recibe un objeto `MPResponse` con un `[CameraScannerResponse]`, representando la respuesta de lectura.

Consulta cómo continuar.
Consulta cómo procesar la respuesta.

[[[
```kotlin
Expand Down
Original file line number Diff line number Diff line change
@@ -1,14 +1,23 @@
# Escanear códigos de barras e QR
# Método legacy para iniciar a câmera

Abaixo você encontrará informações de como iniciar e gerenciar o escâner da [Point Smart](/developers/pt/docs/mp-point/landing) para a leitura de **códigos de barra e QR**.
A função `initBarcodeScanner` da classe `CameraScanner` em nosso SDK é utilizada para invocar a funcionalidade de leitura de códigos que está no dispositivo Point Smart. Além disso, uma função adicional deve ser implementada na atividade que a utiliza para manipular a resposta de leitura.

## Código de barras
> WARNING
>
> Importante
>
> Este método para iniciar a câmera scanner é considerado _legacy_. Recomendamos atualizar sua integração para o [método Callback](/developers/pt/docs/main-apps/camscanner/callback) para ter uma implementação simplificada.
Para iniciar a leitura de códigos de barras da [Point Smart](/developers/pt/docs/mp-point/landing), use a função `initBarcodeScanner` da classe `CameraScanner`.
Consulte como iniciar a leitura de códigos QR e de barras e como gerenciar as respostas a seguir.

Esse processo utiliza uma chamada de câmera mediante `startActivityForResult`, de modo que o método `onActivityResult` deve ser implementado na atividade para manipular a resposta de leitura.

Confira o exemplo a seguir.
## Código de Barras

Para iniciar a leitura de códigos de barras do Point Smart, comece usando a função `initBarcodeScanner` da classe `CameraScanner`.

Esse processo faz uma chamada à câmera através de `startActivityForResult`, de modo que o método `onActivityResult` permita gerenciar a resposta de leitura.

Para sua implementação, consulte o exemplo a seguir.

[[[
```kotlin
Expand All @@ -23,7 +32,7 @@ cameraScanner.initBarcodeScanner(this);

## Código QR

Para iniciar a leitura de códigos QR da [Point Smart](/developers/pt/docs/mp-point/landing), use a função `initQRCodeScanner` da classe `CameraScanner`.
Para iniciar a leitura de códigos QR da Point Smart, use a função `initQRCodeScanner` da classe `CameraScanner`.

Esse processo utiliza uma chamada de câmera mediante `startActivityForResult`, de modo que o método `onActivityResult` deve ser implementado na atividade para manipular a resposta de leitura.

Expand Down
11 changes: 11 additions & 0 deletions guides/mp-point-main-apps/camscanner.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Launch Camera Scanner

Using our SDKs, it is possible to launch the scanner camera of the Point Smart devices to read QR codes and barcodes.

To do this, the **recommended option** is to implement the [Callback method](/developers/en/docs/main-apps/camscanner/callback), which allows for straightforward integration by centralizing the launch in a single method.

> WARNING
>
> Important
>
> If you have an old integration of Main Apps, it is likely that you have implemented a **legacy method to launch the scanner camera**, based on an additional implementation (`onActivityResult`). While this method is still operational, we recommend updating your integration to the Callback method for a simplified implementation. If you need support for your old implementation, please refer to the [documentation](/developers/en/docs/main-apps/camscanner/legacy).
11 changes: 11 additions & 0 deletions guides/mp-point-main-apps/camscanner.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Lanzar cámara scanner

Utilizando nuestros SDKs, es posible lanzar la cámara scanner de los dispositivos Point Smart para leer córidos QR y de barras.

Para hacerlo, la **opción recomendada** es implementar el [método Callback](/developers/es/docs/main-apps/camscanner/callback), que permite una integración sencilla al centralizar el lanzamiento en un solo método.

> WARNING
>
> Importante
>
> Si cuentas con una integración antigua de Main Apps, es probable que tengas implementado un **método legacy para lanzar cámara scanner**, basado una implementación adicional (`onActivityResult`). Si bien este método continúa en funcionamiento, recomendamos actualizar tu integración al método Callback para contar con una implementación simplificada. Si necesitas soporte para tu implementación antigua, accede a la [documentación](/developers/es/docs/main-apps/camscanner/legacy).
Loading

0 comments on commit 8f0e808

Please sign in to comment.