Visão geral da API Bluetooth - Mobile Platform as a Service: Central de Documentação do Alibaba Cloud

Requisitos de versão

Bluetooth	Versão do mPaaS	Android/iOS
Bluetooth Low Energy (BLE)	mPaaS 10.1.60 ou posterior	Android: 5,0 ou posterior iOS: Nenhum requisito
Bluetooth tradicional	mPaaS 10.1.60 ou posterior	-

Fluxo do processo

BLE

Bluetooth tradicional

traditional

API Bluetooth

Bluetooth Low Energy

API	Descrição
my.connectBLEDevice	Conecta-se a dispositivos Bluetooth Low Energy.
my.disconnectBLEDevice	Desconecta dispositivos Bluetooth Low Energy.
my.getBLEDeviceCharacteristics	Obtém as características de dispositivos Bluetooth Low Energy.
my.getBLEDeviceServices	Recupera todos os serviços dos dispositivos Bluetooth Low Energy descobertos, incluindo os conectados.
my.notifyBLECharacteristicValueChange	Ative notificações de alteração no valor da característica.
my.offBLECharacteristicValueChange	Desativa notificações de alteração no valor da característica.
my.offBLEConnectionStateChanged	Remove o listener de eventos de alteração do estado de conexão.
my.onBLECharacteristicValueChange	Registra um listener para eventos de alteração do valor da característica.
my.onBLEConnectionStateChanged	Monitora eventos de alteração do estado de conexão, como perda ou desconexão do dispositivo.
my.readBLECharacteristicValue	Lê o valor da característica.
my.writeBLECharacteristicValue	Grava dados no valor da característica.

Bluetooth tradicional

API	Descrição
my.closeBluetoothAdapter	Fecha o módulo Bluetooth no mini programa.
my.getBluetoothAdapterState	Consulta o status do adaptador Bluetooth no mini programa.
my.getBluetoothDevices	Lista todos os dispositivos Bluetooth Low Energy descobertos, inclusive os conectados.
my.getConnectedBluetoothDevices	Retorna os dispositivos Bluetooth conectados.
my.offBluetoothAdapterStateChange	Cancela o monitoramento de eventos de alteração do estado do adaptador.
my.offBluetoothDeviceFound	Remove o listener de eventos de descoberta de novos dispositivos Bluetooth.
my.onBluetoothDeviceFound	Dispara um evento quando um novo dispositivo Bluetooth é encontrado.
my.onBluetoothAdapterStateChange	Monitora eventos de alteração do estado do adaptador Bluetooth.
my.openBluetoothAdapter	Inicializa o módulo Bluetooth no mini programa.
my.startBluetoothDevicesDiscovery	Inicia a busca por dispositivos Bluetooth próximos.
my.stopBluetoothDevicesDiscovery	Interrompe a busca por dispositivos Bluetooth próximos.

Código de exemplo

//Initialize
my.openBluetoothAdapter({
  success: (res) => {
      console.log(res);
  }
});
//Register discovery event
my.onBluetoothDeviceFound({
  success: (res) => {
    let device = res.devices[0];
    //Connect the discovered device
    my.connectBLEDevice({
      deviceId: deviceId,
      success: (res) => {
        console.log(res)
      },
      fail:(res) => {
      },
      complete: (res)=>{
      }
    });
    //Stop discovering
    my.stopBluetoothDevicesDiscovery({
      success: (res) => {
        console.log(res)
      },
      fail:(res) => {
      },
      complete: (res)=>{
      }
    });
  }
});
//Register connection event
my.onBLEConnectionStateChanged({
  success: (res) => {
      console.log(res);
    if (res.connected) {
        //Start reading and writing notify and other operations
        my.notifyBLECharacteristicValueChange({
          deviceId: deviceId,
          serviceId: serviceId,
          characteristicId: characteristicId,
          success: (res) => {
              console.log(res)
          },
          fail:(res) => {
          },
          complete: (res)=>{
          }
        });
    }
  }
});
//Register the read or notify data reception events
my.onBLECharacteristicValueChange({
  success: (res) => {
      console.log(res);
  }
});
//Start discovering
my.startBluetoothDevicesDiscovery({
  services: ['fff0'],
  success: (res) => {
      console.log(res)
  },
  fail:(res) => {
  },
  complete: (res)=>{
  }
});

//Disconnect
my.disconnectBLEDevice({
  deviceId: deviceId,
  success: (res) => {
      console.log(res)
  },
  fail:(res) => {
  },
  complete: (res)=>{
  }
});

// Unregister events
my.offBluetoothDeviceFound();
my.offBLEConnectionStateChanged();
my.offBLECharacteristicValueChange();

//Exit bluetooth module
my.closeBluetoothAdapter({
  success: (res) => {
  },
  fail:(res) => {
  },
  complete: (res)=>{
  }
});