Comandos disponíveis

Veja abaixo quais são os comandos disponíveis para conectar via bluetooth um dispositivo externo compatível.

Os tipos de dispositivos bluetooth permitidos são: teclados, leitores de códigos de barras e impressoras.

Ligar e desligar

Para ligar e desligar um dispositivo bluetooth a partir de um MiniApp, o comando JS bluetooth_enable deve ser executado enviando uma ação como parâmetro para indicar a action a ser realizada.

Parâmetro	Tipo	Obrigatório	Valores possíveis	Descrição
action	string	true	on off	Liga ou desliga o dispositivo bluetooth.

Se o comando for bem-sucedido, o retorno de chamada enviará um valor success.

Exemplo de requisição:

MobileWebKit.executeNative(
   {
       "method": 'bluetooth_enable',
       "args": {"action": on},
       "callback": function (result, error) {
           if (result === "success") {
               //  Escreva o código com sucesso aqui
           }
       }
   }
)

Obter status

Para saber se o bluetooth está ativado ou não no MiniApp, você deve executar o comando JS bluetooth_status em que o resultado é um boolean que indica se está ativado.

Exemplo de código:

MobileWebKit.executeNative(
        {
            "method": 'bluetooth_status',
            "args": {},
            "callback": function (isOn, error) {
                if (isOn) {
                    // Escreva o código aqui se o bluetooth estiver ligado

                } else {
                    // Escreva o código aqui se o bluetooth estiver desligado

                }
            }
        }
    )

Descobrir dispositivos (emparelhados e para emparelhamento)

Para descobrir os dispositivos visíveis para iniciar um emparelhamento, o comando JS bluetooth_devices deve ser executado através do envio do parâmetro state com o valor de all e, para listar os dispositivos pareados, o comando JS bluetooth_devices deve ser executado enviando o parâmetro state com o valor de paired.

Parâmetro	Tipo	Obrigatório	Valores possíveis	Descrição
state	string	true	all paired	Lista os dispositivos visíveis.
devices	list	-	-	Retorna uma lista de dados do dispositivo, como: id, nome e endereço MAC.
id	string	-	-	Identificador exclusivo associado ao dispositivo. Este ID é gerado aleatoriamente pelo superAPP.
name	string	-	-	Indica o nome associado ao dispositivo.
address	string	-	-	Indica o endereço MAC do dispositivo.

Exemplo de código:

MobileWebKit.executeNative(
        {
            "method": 'bluetooth_devices',
            "args": {"state": state},
            "callback": function (result, error) {

                if (error != null) {
                    // Ocorreu um erro
                    return
                }

                let status = result["status"];
                let devices = result["devices"];

                for (let i = 0; i < devices.length; i++) {
                    let device = devices[i];
                    // Dados do dispositivo
                    let id = device["id"];
                    let name = device["name"];
                    let address = device["address"];
                    // Escreva seu código aqui para cada dispositivo
                }
            }
        }

Emparelhar e desemparelhar um dispositivo

Para emparelhar um dispositivo, execute o comando JS bluetooth_pair_request enviando o ID do dispositivo fornecido pelo comando de descobrir dispositivos (bluetooth_devices).

Parâmetro	Tipo	Obrigatório	Valores possíveis	Descrição
id	string	true	UUID	O ID do dispositivo a ser emparelhado.

Exemplo de código:

MobileWebKit.executeNative(
        {
            "method": 'bluetooth_pair_request',
            "args": {
                "id": id
            },
            "callback": function (result, error) {
                if (result === "success") {
                    // Escreva seu código aqui
            }
        }
    )

Para desemparelhar um dispositivo, execute o comando JS bluetooth_pair_request enviando o ID do dispositivo fornecido pelo comando de descobrir dispositivos (bluetooth_devices).

Parâmetro	Tipo	Obrigatório	Valores possíveis	Descrição
id	string	true	UUID	O ID do dispositivo a ser desemparelhado.

Exemplo de código:

MobileWebKit.executeNative(
        {
            "method": 'bluetooth_unpair',
            "args": {
                "id": id
            },
            "callback": function (result, error) {
                if (result === "success") {
                    // Escreva seu código aqui
                }
            }
        }
    )

Imprimir utilizando impressora Bluetooth

Para emparelhar uma impressora, execute o comando bluetooth_printer_devices como no exemplo abaixo.

MobileWebKit.executeNative(
        {
            "method": 'bluetooth_printer_devices',
            "args": {
            },
            "callback": callback
                }
            }
        }
    )

Com a impressora emparelhada, execute o comando bluetooth_print para imprimir nesta impressora. Envie o ID da impressora fornecido pelo comando de descobrir dispositivos (bluetooth_devices) e o texto a ser impresso.

function printData(data, printerDeviceId){

MobileWebKit.executeNative(
        {
            "method": 'bluetooth_print',
            "args": {
                "id": printerDeviceId,
                "data": data
            },
            "callback": function (result,error){
                console.log("Print Result: " + result + "Error: " + error);
            }
        }
    )
}

Parâmetro	Tipo	Obrigatório	Valores possíveis	Descrição
id	string	true	printerDeviceId	ID de impressora válido.
data	string	true	text printed	Dados a serem impressos.