chrome.bluetoothSocket

Açıklama

RFCOMM ve L2CAP bağlantılarını kullanarak Bluetooth cihazlarına veri göndermek ve bu cihazlardan veri almak için chrome.bluetoothSocket API'yi kullanın.

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarlar manifest dosyasında beyan edilmelidir.

"bluetooth"

Türler

AcceptError

Enum

"system_error"
Bir sistem hatası oluştu ve bağlantı kurtarılamayabilir.

"not_listening"
Soket dinlemiyor.

AcceptErrorInfo

Özellikler

  • Neyin yanlış gittiğini gösteren bir hata kodu.

  • errorMessage

    dize

    Hata mesajı.

  • socketId

    sayı

    Sunucu yuvası tanımlayıcısı.

AcceptInfo

Özellikler

  • clientSocketId

    sayı

    İstemci yuvası tanımlayıcısı, yani yeni kurulan bağlantının yuva tanımlayıcısı. Bu soket tanımlayıcısı yalnızca chrome.bluetoothSocket ad alanındaki işlevlerle kullanılmalıdır. İstemci soketinin başlangıçta duraklatıldığını ve veri almaya başlamak için uygulama tarafından açıkça duraklatmanın kaldırılması gerektiğini unutmayın.

  • socketId

    sayı

    Sunucu yuvası tanımlayıcısı.

CreateInfo

Özellikler

  • socketId

    sayı

    Yeni oluşturulan soketin kimliği. Bu API'den oluşturulan soket kimliklerinin, [sockets.tcp](../sockets_tcp/) API gibi diğer API'lerden oluşturulan soket kimlikleriyle uyumlu olmadığını unutmayın.

ListenOptions

Özellikler

  • backlog

    number isteğe bağlı

    Soketin dinleme sırasının uzunluğu. Varsayılan değer, işletim sisteminin ana makine alt sistemine bağlıdır.

  • kanal

    number isteğe bağlı

    listenUsingRfcomm tarafından kullanılan RFCOMM kanalı. Belirtilirse bu kanal daha önce kullanılmamış olmalıdır. Aksi takdirde yöntem çağrısı başarısız olur. Belirtilmediğinde, kullanılmayan bir kanal otomatik olarak ayrılır.

  • psm

    number isteğe bağlı

    listenUsingL2cap tarafından kullanılan L2CAP PSM. Belirtilmişse bu PSM daha önce kullanılmamış olmalıdır. Aksi takdirde yöntem çağrısı başarısız olur. Belirtilmediğinde, kullanılmayan bir PSM otomatik olarak ayrılır.

ReceiveError

Enum

"disconnected"
Bağlantı kesildi.

"system_error"
Bir sistem hatası oluştu ve bağlantı kurtarılamayabilir.

"not_connected"
Priz bağlanmamıştır.

ReceiveErrorInfo

Özellikler

  • Neyin yanlış gittiğini gösteren bir hata kodu.

  • errorMessage

    dize

    Hata mesajı.

  • socketId

    sayı

    Soket tanımlayıcısı.

ReceiveInfo

Özellikler

  • aktarma

    ArrayBuffer

    En fazla bufferSize boyutunda alınan veriler.

  • socketId

    sayı

    Soket tanımlayıcısı.

SocketInfo

Özellikler

  • adres

    dize isteğe bağlı

    Temel soket bağlıysa bağlandığı cihazın Bluetooth adresini içerir.

  • bufferSize

    number isteğe bağlı

    Veri almak için kullanılan arabelleğin boyutu. Arabellek boyutu açıkça belirtilmediyse değer sağlanmaz.

  • bağlandı

    boolean

    Soketin uzak bir eşe bağlanıp bağlanmadığını gösteren işaret.

  • ad

    dize isteğe bağlı

    Soketle ilişkili, uygulama tarafından tanımlanan dize.

  • duraklatıldı

    boolean

    Bağlı bir soketin, eşinin daha fazla veri göndermesini engelleyip engellemediğini veya dinleme soketindeki bağlantı isteklerinin onAccept etkinliği aracılığıyla gönderilip gönderilmediğini ya da dinleme kuyruğu yedek kuyruğuna alınıp alınmadığını belirten işaret. Şu sayfaya göz atın: setPaused. Varsayılan değer "false" değeridir.

  • kalıcı

    boolean

    Uygulamanın etkinlik sayfası kaldırıldığında soketin açık kalıp kalmadığını belirten işaret (SocketProperties.persistent bölümüne bakın). Varsayılan değer "false"tur.

  • socketId

    sayı

    Soket tanımlayıcısı.

  • uuid

    dize isteğe bağlı

    Temel soket bağlıysa bağlandığı hizmet UUID'si hakkında bilgi içerir. Aksi takdirde, temel soket dinliyorsa dinlediği hizmet UUID'si hakkında bilgi içerir.

SocketProperties

Özellikler

  • bufferSize

    number isteğe bağlı

    Veri almak için kullanılan arabelleğin boyutu. Varsayılan değer 4.096'dır.

  • ad

    dize isteğe bağlı

    Soketle ilişkilendirilmiş, uygulama tarafından tanımlanan bir dize.

  • kalıcı

    boolean isteğe bağlı

    Uygulamanın etkinlik sayfası kaldırıldığında soketin açık bırakılıp bırakılmadığını gösteren işaret (bkz. Uygulama Yaşam Döngüsünü Yönetme). Varsayılan değer false. değeridir. Uygulama yüklendiğinde, daha önce persistent=true ile açılan tüm soketler getSockets ile getirilebilir.

Yöntemler

close()

Promise 
chrome.bluetoothSocket.close(
  socketId: number,
  callback?: function,
): Promise<void>

Soketin bağlantısını keser ve soketi yok eder. Oluşturulan her soket, kullanımdan sonra kapatılmalıdır. İşlev çağrılır çağrılmaz soket kimliği artık geçerli olmaz. Ancak soketin yalnızca geri çağırma işlemi çağrıldığında kapatılacağı garanti edilir.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

connect()

Promise 
chrome.bluetoothSocket.connect(
  socketId: number,
  address: string,
  uuid: string,
  callback?: function,
): Promise<void>

Soketi uzaktaki bir Bluetooth cihazına bağlar. connect işlemi başarıyla tamamlandığında, eşten veri alındığında onReceive etkinlikleri tetiklenir. Çalışma zamanı paket alırken bir ağ hatası oluşursa onReceiveError etkinliği tetiklenir. Bu noktada, setPaused(false) yöntemi çağrılana kadar bu soket için başka onReceive etkinliği tetiklenmez.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • adres

    dize

    Bluetooth cihazının adresi.

  • uuid

    dize

    Bağlanılacak hizmetin UUID'si.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

create()

Promise 
chrome.bluetoothSocket.create(
  properties?: SocketProperties,
  callback?: function,
): Promise<CreateInfo>

Bluetooth yuvası oluşturur.

Parametreler

  • mülkler

    SocketProperties isteğe bağlı

    Soket özellikleri (isteğe bağlı).

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (createInfo: CreateInfo) => void

    • createInfo

      CreateInfo

      Soket oluşturma işleminin sonucu.

İadeler

  • Promise<CreateInfo>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

disconnect()

Promise 
chrome.bluetoothSocket.disconnect(
  socketId: number,
  callback?: function,
): Promise<void>

Soketin bağlantısını keser. Soket tanımlayıcısı geçerli olmaya devam eder.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getInfo()

Promise 
chrome.bluetoothSocket.getInfo(
  socketId: number,
  callback?: function,
): Promise<SocketInfo>

Belirtilen soketin durumunu alır.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (socketInfo: SocketInfo) => void

    • socketInfo

      SocketInfo

      Soket bilgilerini içeren nesne.

İadeler

  • Promise<SocketInfo>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getSockets()

Promise 
chrome.bluetoothSocket.getSockets(
  callback?: function,
): Promise<SocketInfo[]>

Uygulamaya ait olan ve şu anda açık olan yuvaların listesini alır.

Parametreler

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (sockets: SocketInfo[]) => void

İadeler

  • Promise<SocketInfo[]>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

listenUsingL2cap()

Promise 
chrome.bluetoothSocket.listenUsingL2cap(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
): Promise<void>

L2CAP protokolünü kullanarak bağlantıları dinleyin.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • uuid

    dize

    Dinlemek için hizmet UUID'si.

  • seçenekler

    ListenOptions isteğe bağlı

    Hizmet için isteğe bağlı ek seçenekler.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

listenUsingRfcomm()

Promise 
chrome.bluetoothSocket.listenUsingRfcomm(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
): Promise<void>

RFCOMM protokolünü kullanarak bağlantıları dinleyin.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • uuid

    dize

    Dinlemek için hizmet UUID'si.

  • seçenekler

    ListenOptions isteğe bağlı

    Hizmet için isteğe bağlı ek seçenekler.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

send()

Promise 
chrome.bluetoothSocket.send(
  socketId: number,
  data: ArrayBuffer,
  callback?: function,
): Promise<number>

Belirtilen Bluetooth soketiyle ilgili verileri gönderir.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • aktarma

    ArrayBuffer

    Gönderilecek veriler.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (bytesSent: number) => void

    • bytesSent

      sayı

      Gönderilen bayt sayısı.

İadeler

  • Promise<number>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setPaused()

Promise 
chrome.bluetoothSocket.setPaused(
  socketId: number,
  paused: boolean,
  callback?: function,
): Promise<void>

Bağlı bir soketin eşinden mesaj almasını veya dinleme soketinin yeni bağlantıları kabul etmesini etkinleştirir ya da devre dışı bırakır. Varsayılan değer "false" değeridir. Bağlı bir soketi duraklatmak genellikle bir uygulama tarafından eşi tarafından gönderilen verileri sınırlamak için kullanılır. Bağlı bir soket duraklatıldığında onReceiveetkinliği oluşturulmaz. Bir soket bağlanıp duraklatma kaldırıldığında, mesajlar alındığında onReceive etkinlikleri tekrar tetiklenir. Bir dinleme soketi duraklatıldığında, arka plan görevi dolana kadar yeni bağlantılar kabul edilir. Ardından ek bağlantı istekleri reddedilir. onAccept etkinlikleri yalnızca soket duraklatılmadığında tetiklenir.

Parametreler

  • socketId

    sayı

  • duraklatıldı

    boolean

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

update()

Promise 
chrome.bluetoothSocket.update(
  socketId: number,
  properties: SocketProperties,
  callback?: function,
): Promise<void>

Soket özelliklerini günceller.

Parametreler

  • socketId

    sayı

    Soket tanımlayıcısı.

  • mülkler

    SocketProperties

    Güncellenecek mülkler.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onAccept

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

Belirli bir yuva için bağlantı kurulduğunda oluşturulan etkinlik.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (info: AcceptInfo) => void

onAcceptError

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

Çalışma zamanı, belirli sokette yeni bağlantıları beklerken bir ağ hatası oluştuğunda tetiklenen etkinlik. Bu etkinlik tetiklendikten sonra soket paused olarak ayarlanır ve bu soket için başka onAccept etkinlikleri tetiklenmez.

Parametreler

onReceive

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

Belirli bir soket için veri alındığında tetiklenen etkinlik.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (info: ReceiveInfo) => void

onReceiveError

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

Çalışma zamanı, soketteki verileri beklerken bir ağ hatası oluştuğunda tetiklenen etkinlik. Bu etkinlik tetiklendikten sonra soket paused olarak ayarlanır ve bu soket için başka onReceive etkinlikleri tetiklenmez.

Parametreler