Recherche

La recherche trouve les imprimantes Brother à proximité. Les résultats arrivent via onPrinterAvailable. Appelez-la après Installation. Enregistrez l’écouteur avant search, conservez le BRLMChannelResult découvert, en particulier channelInfo et port, puis passez à Impression. Liste complète des événements : Événements.

search

Enregistrez onPrinterAvailable, conservez le canal, puis lancez une recherche Wi-Fi. L’appel search lui-même renvoie void.

import type { PluginListenerHandle } from '@capacitor/core';
import {
  BrotherPrint,
  BrotherPrintEventsEnum,
  BRLMPrinterPort,
} from '@rdlabo/capacitor-brotherprint';
import type { BRLMChannelResult } from '@rdlabo/capacitor-brotherprint';

let discovered: BRLMChannelResult | undefined;
let availableHandle: PluginListenerHandle | undefined;

const searchWifiPrinters = async () => {
  if (!availableHandle) {
    availableHandle = await BrotherPrint.addListener(
    BrotherPrintEventsEnum.onPrinterAvailable,
    (printer) => {
      discovered = printer;
      console.log('channelInfo', printer.channelInfo);
    },
    );
  }

  await BrotherPrint.search({
    port: BRLMPrinterPort.wifi,
    searchDuration: 15, // secondes
  });
};

const stopSearching = async () => {
  try {
    await BrotherPrint.cancelSearchWiFiPrinter();
  } finally {
    await availableHandle?.remove();
    availableHandle = undefined;
  }
};

Appelez searchWifiPrinters depuis le bouton de recherche et attendez stopSearching lorsque l’utilisateur quitte l’écran.

Sur iOS, bluetooth liste d’abord les imprimantes MFi connectées. Si aucune n’est connectée, l’application affiche le sélecteur système d’accessoires Bluetooth pour choisir et appairer une imprimante. La promesse de recherche se termine après le callback du sélecteur ; les erreurs du sélecteur rejettent la promesse.

Pour les imprimantes compatibles BLE, utilisez port: BRLMPrinterPort.bluetoothLowEnergy. Sur iOS, cela utilise startBLESearch sans le sélecteur d’accessoires Bluetooth. Transmettez sans modification le channelInfo de l’imprimante découverte, son nom local BLE, à isChannelAvailable ou printImage. Les erreurs de recherche BLE rejettent la promesse de recherche. QL-820NWB/QL-820NWBc ne prennent pas en charge l’impression BLE ; utilisez bluetooth ou wifi pour ces modèles.

Sur Android, appairez une imprimante Bluetooth dans les réglages système avant d’appeler search avec bluetooth ; le SDK liste les imprimantes appairées et ne fournit pas le sélecteur d’accessoires iOS. Les recherches Bluetooth et BLE se terminent à la fin de la recherche, ou sont rejetées en cas d’erreur du SDK. Android 12 et les versions ultérieures demandent les autorisations Appareils à proximité ; Android 11 et les versions antérieures demandent l’autorisation de localisation pour BLE. isChannelAvailable renvoie false si l’autorisation Bluetooth manque.

searchDuration s’applique à wifi et bluetoothLowEnergy. usb est réservé à Android. Si rien n’est trouvé, vous ne recevez ni erreur ni imprimante. Les signatures figurent sur la page API.

Sur Android, les recherches Bluetooth Classic renvoient les appareils appairés. Pour ne conserver que ceux déclarant la classe Bluetooth Imaging/Printer :

await BrotherPrint.search({
  port: BRLMPrinterPort.bluetooth,
  searchDuration: 15,
  bluetoothPrintersOnly: true,
});

bluetoothPrintersOnly vaut false par défaut, ce qui conserve les résultats non filtrés. Il est ignoré sur iOS et pour les autres ports, y compris BLE. Le filtre ne dépend pas du nom des appareils et n’identifie pas les produits Brother : les imprimantes d’autres fabricants peuvent toujours apparaître. Lorsqu’il est activé, les imprimantes dont la classe Bluetooth est absente ou n’est pas celle d’une imprimante sont exclues.

isChannelAvailable

Si vous avez enregistré le dernier BRLMChannelResult, vérifiez si ce canal reste utilisable avant Impression.

import { BrotherPrint } from '@rdlabo/capacitor-brotherprint';
import type { BRLMChannelResult } from '@rdlabo/capacitor-brotherprint';

const checkChannel = async (lastPrinter: BRLMChannelResult) => {
  const { result } = await BrotherPrint.isChannelAvailable(lastPrinter);
  if (!result) {
    await BrotherPrint.search({
      port: lastPrinter.port,
      searchDuration: 15,
    });
  }
};

cancelSearchWiFiPrinter / cancelSearchBluetoothPrinter

Utilisez ces méthodes pour arrêter une recherche active avant son délai d’expiration, notamment lorsque l’utilisateur quitte l’écran.

import { BrotherPrint } from '@rdlabo/capacitor-brotherprint';

await BrotherPrint.cancelSearchWiFiPrinter();
await BrotherPrint.cancelSearchBluetoothPrinter();

Consultez API pour les signatures d’annulation.