chrome.bluetoothSocket

Description

Utilisez l'API chrome.bluetoothSocket pour envoyer et recevoir des données vers des appareils Bluetooth à l'aide de connexions RFCOMM et L2CAP.

Fichier manifeste

Les clés suivantes doivent être déclarées dans le fichier manifeste pour utiliser cette API.

"bluetooth"

Types

AcceptError

Énumération

"system_error"
Une erreur système s'est produite et la connexion est peut-être irrécupérable.

"not_listening"
Le socket n'écoute pas.

AcceptErrorInfo

Propriétés

  • erreur

    AcceptError

    Code d'erreur indiquant le problème rencontré.

  • Message d'erreur

    chaîne

    Message d'erreur.

  • socketId

    Nombre

    Identifiant de socket du serveur.

AcceptInfo

Propriétés

  • clientSocketId

    Nombre

    Identifiant de socket client, c'est-à-dire l'identifiant de socket de la nouvelle connexion. Cet identifiant de socket ne doit être utilisé qu'avec des fonctions de l'espace de noms chrome.bluetoothSocket. Notez que le socket client est initialement mis en pause et doit être explicitement réactivé par l'application pour commencer à recevoir des données.

  • socketId

    Nombre

    Identifiant de socket du serveur.

CreateInfo

Propriétés

  • socketId

    Nombre

    ID du socket nouvellement créé. Notez que les ID de socket créés à partir de cette API ne sont pas compatibles avec ceux créés à partir d'autres API, telles que l'API [sockets.tcp](../sockets_tcp/).

ListenOptions

Propriétés

  • en attente

    numéro facultatif

    Longueur de la file d'attente d'écoute du socket. La valeur par défaut dépend du sous-système hôte du système d'exploitation.

  • chaîne

    numéro facultatif

    Canal RFCOMM utilisé par listenUsingRfcomm. Si ce canal est spécifié, il ne doit pas être utilisé précédemment. Sinon, l'appel de méthode échouera. Si aucune valeur n'est spécifiée, une version inutilisée est automatiquement allouée.

  • psm

    numéro facultatif

    PSM L2CAP utilisé par listenUsingL2cap. Si cette valeur est spécifiée, ce PSM ne doit pas avoir été utilisé précédemment. Dans le cas contraire, l'appel de méthode échoue. Si aucune valeur n'est spécifiée, un PSM inutilisé est automatiquement alloué.

ReceiveError

Énumération

"disconnected"
La connexion a été interrompue.

"system_error"
Une erreur système s'est produite, et la connexion est peut-être irrécupérable.

"not_connected"
La prise n'est pas branchée.

ReceiveErrorInfo

Propriétés

  • erreur

    ReceiveError

    Code d'erreur indiquant le problème rencontré.

  • Message d'erreur

    chaîne

    Message d'erreur.

  • socketId

    Nombre

    Identifiant de socket.

ReceiveInfo

Propriétés

  • données

    ArrayBuffer

    Données reçues, avec une taille maximale de bufferSize.

  • socketId

    Nombre

    Identifiant de socket.

SocketInfo

Propriétés

  • adresse

    chaîne facultatif

    Si le socket sous-jacent est connecté, contient l'adresse Bluetooth de l'appareil auquel il est connecté.

  • bufferSize

    numéro facultatif

    Taille du tampon utilisé pour recevoir des données. Si aucune taille de mémoire tampon n'a été spécifiée explicitement, la valeur n'est pas fournie.

  • connecté

    booléen

    Indique si le socket est connecté à un pair distant.

  • nom

    chaîne facultatif

    Chaîne définie par l'application associée au socket.

  • mis en veille

    booléen

    Indique si un socket connecté empêche son pair d'envoyer plus de données, ou si les requêtes de connexion sur un socket d'écoute sont envoyées via l'événement onAccept ou placées en file d'attente dans les tâches en attente de la file d'attente d'écoute. Consultez les setPaused. La valeur par défaut est "false".

  • SSD

    booléen

    Indique si le socket reste ouvert lorsque la page d'événement de l'application est déchargée (voir SocketProperties.persistent). La valeur par défaut est "false".

  • socketId

    Nombre

    Identifiant de socket.

  • uuid

    chaîne facultatif

    Si le socket sous-jacent est connecté, contient des informations sur l'UUID du service auquel il est connecté, ou, si le socket sous-jacent écoute, contient des informations sur l'UUID du service sur lequel il écoute.

SocketProperties

Propriétés

  • bufferSize

    numéro facultatif

    Taille du tampon utilisé pour recevoir des données. La valeur par défaut est 4096.

  • nom

    chaîne facultatif

    Chaîne définie par l'application associée au socket.

  • SSD

    Booléen facultatif

    Indique si le socket est laissé ouvert lorsque la page d'événements de l'application est déchargée (voir Gérer le cycle de vie de l'application). La valeur par défaut est false.. Lorsque l'application est chargée, tous les sockets précédemment ouverts avec persistent=true peuvent être récupérés avec getSockets.

Méthodes

close()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.close(
  socketId: number,
  callback?: function,
)

Débranche et détruit le socket. Chaque socket créé doit être fermé après utilisation. L'ID de socket n'est plus valide dès que la fonction est appelée. Toutefois, la fermeture du socket n'est garantie que lorsque le rappel est appelé.

Paramètres

  • socketId

    Nombre

    Identifiant de socket.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

connect()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.connect(
  socketId: number,
  address: string,
  uuid: string,
  callback?: function,
)

Permet de brancher la prise de courant à un appareil Bluetooth distant. Lorsque l'opération connect se termine correctement, des événements onReceive sont déclenchés lorsque des données sont reçues du pair. Si une erreur réseau se produit pendant que l'environnement d'exécution reçoit des paquets, un événement onReceiveError est déclenché. Aucun autre événement onReceive ne sera alors déclenché pour ce socket tant que la méthode setPaused(false) n'est pas appelée.

Paramètres

  • socketId

    Nombre

    Identifiant de socket.

  • adresse

    chaîne

    Adresse de l'appareil Bluetooth.

  • uuid

    chaîne

    UUID du service auquel se connecter.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

create()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.create(
  properties?: SocketProperties,
  callback?: function,
)

Crée un socket Bluetooth.

Paramètres

  • du bucket

    SocketProperties facultatif

    Propriétés du socket (facultatif).

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (createInfo: CreateInfo) => void

    • createInfo

      CreateInfo

      Résultat de la création du socket.

Renvoie

  • Promise&lt;CreateInfo&gt;

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

disconnect()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.disconnect(
  socketId: number,
  callback?: function,
)

Débranche le support. L'identifiant de socket reste valide.

Paramètres

  • socketId

    Nombre

    Identifiant de socket.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getInfo()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.getInfo(
  socketId: number,
  callback?: function,
)

Récupère l'état du socket donné.

Paramètres

  • socketId

    Nombre

    Identifiant de socket.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (socketInfo: SocketInfo) => void

    • socketInfo

      SocketInfo

      Objet contenant les informations de socket

Renvoie

  • Promise&lt;SocketInfo&gt;

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getSockets()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.getSockets(
  callback?: function,
)

Récupère la liste des sockets actuellement ouverts appartenant à l'application.

Paramètres

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (sockets: SocketInfo[]) => void

Renvoie

  • Promise&lt;SocketInfo[]&gt;

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

listenUsingL2cap()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.listenUsingL2cap(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
)

Écoutez les connexions à l'aide du protocole L2CAP.

Paramètres

  • socketId

    Nombre

    Identifiant de socket.

  • uuid

    chaîne

    UUID du service à écouter.

  • options

    ListenOptions facultatif

    Options supplémentaires facultatives pour le service.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

listenUsingRfcomm()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.listenUsingRfcomm(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
)

Écoutez les connexions à l'aide du protocole RFCOMM.

Paramètres

  • socketId

    Nombre

    Identifiant de socket.

  • uuid

    chaîne

    UUID du service à écouter.

  • options

    ListenOptions facultatif

    Options supplémentaires facultatives pour le service.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

send()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.send(
  socketId: number,
  data: ArrayBuffer,
  callback?: function,
)

Envoie des données via le support Bluetooth donné.

Paramètres

  • socketId

    Nombre

    Identifiant de socket.

  • données

    ArrayBuffer

    Données à envoyer.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (bytesSent: number) => void

    • bytesSent

      Nombre

      Nombre d'octets envoyés.

Renvoie

  • Promise&lt;number&gt;

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

setPaused()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.setPaused(
  socketId: number,
  paused: boolean,
  callback?: function,
)

Active ou empêche un socket connecté de recevoir des messages de son pair, ou un socket d'écoute d'accepter de nouvelles connexions. La valeur par défaut est "false". La mise en pause d'un socket connecté est généralement utilisée par une application pour limiter les données envoyées par son pair. Lorsqu'un socket connecté est suspendu, aucun événement onReceive n'est déclenché. Lorsqu'un socket est connecté et réactivé, les événements onReceive sont déclenchés à nouveau à la réception de messages. Lorsqu'un socket d'écoute est suspendu, les nouvelles connexions sont acceptées jusqu'à ce que le nombre de tâches en attente soit saturé, puis les demandes de connexion supplémentaires sont refusées. Les événements onAccept ne sont déclenchés que lorsque le socket est réactivé.

Paramètres

  • socketId

    Nombre

  • mis en veille

    booléen

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

update()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothSocket.update(
  socketId: number,
  properties: SocketProperties,
  callback?: function,
)

Met à jour les propriétés du socket.

Paramètres

  • socketId

    Nombre

    Identifiant de socket.

  • du bucket

    SocketProperties

    Propriétés à mettre à jour.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onAccept

chrome.bluetoothSocket.onAccept.addListener(
  callback: function,
)

Événement déclenché lorsqu'une connexion a été établie pour un socket donné.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit: 

    (info: AcceptInfo) => void

onAcceptError

chrome.bluetoothSocket.onAcceptError.addListener(
  callback: function,
)

Événement déclenché lorsqu'une erreur réseau s'est produite alors que l'environnement d'exécution attendait de nouvelles connexions sur le socket donné. Une fois cet événement déclenché, le socket est défini sur paused, et aucun autre événement onAccept n'est déclenché pour ce socket.

Paramètres

onReceive

chrome.bluetoothSocket.onReceive.addListener(
  callback: function,
)

Événement déclenché lorsque des données ont été reçues pour un socket donné.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit: 

    (info: ReceiveInfo) => void

onReceiveError

chrome.bluetoothSocket.onReceiveError.addListener(
  callback: function,
)

Événement déclenché lorsqu'une erreur réseau s'est produite alors que l'environnement d'exécution attendait des données sur le socket. Une fois cet événement déclenché, le socket est défini sur paused, et aucun autre événement onReceive n'est déclenché pour ce socket.

Paramètres