Comandos disponĂveis
Veja abaixo quais sĂŁo os comandos disponĂveis para conectar via bluetooth um dispositivo externo compatĂvel.
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:
javascript
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:
javascript
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:
javascript
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:
javascript
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:
javascript
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.
javascript
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.
javascript
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. |