chrome.bluetoothSocket

Açıklama

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

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarların manifest'te beyan edilmesi gerekir.

"bluetooth"

Türler

AcceptError

Enum

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

"not_listening"
Soket dinlemiyor.

AcceptErrorInfo

Özellikler

  • Sorunun ne olduğunu gösteren bir hata kodu.

  • errorMessage

    dize

    Hata mesajı.

  • socketId

    sayı

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

AcceptInfo

Özellikler

  • clientSocketId

    sayı

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

  • socketId

    sayı

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

CreateInfo

Özellikler

  • socketId

    sayı

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

ListenOptions

Özellikler

  • iş listesi

    numara isteğe bağlı

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

  • kanal

    numara isteğe bağlı

    listenUsingRfcomm tarafından kullanılan RFCOMM Kanalı. Belirtilirse bu kanal daha önce kullanımda olmamalı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.

  • /sn

    numara isteğe bağlı

    listenUsingL2cap tarafından kullanılan L2CAP PSM. Belirtilirse bu PSM daha önce kullanımda olmamalı veya yöntem çağrısının başarısız olması gerekir. 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ılamaz.

"not_connected"
Yuva bağlanmadı.

ReceiveErrorInfo

Özellikler

  • Sorunun ne olduğunu gösteren bir hata kodu.

  • errorMessage

    dize

    Hata mesajı.

  • socketId

    sayı

    Yuva tanımlayıcısı.

ReceiveInfo

Özellikler

  • veri

    ArrayBuffer

    Maksimum bufferSize boyutunda alınan veriler.

  • socketId

    sayı

    Yuva tanımlayıcısı.

SocketInfo

Özellikler

  • adres

    string isteğe bağlı

    Alttaki yuva bağlıysa bağlı olduğu cihazın Bluetooth adresini içerir.

  • bufferSize

    numara isteğe bağlı

    Verileri almak için kullanılan arabelleğin boyutu. Açıkça herhangi bir tampon boyutu belirtilmediyse değer sağlanmaz.

  • bağlandı

    boolean

    Yuvanın uzak bir eşe bağlı olup olmadığını gösteren işaret.

  • ad

    string isteğe bağlı

    Yuvayla ilişkilendirilen uygulama tanımlı dize.

  • duraklatıldı

    boolean

    Bağlı bir yuvanın eşinin daha fazla veri göndermesini engellediğini veya bir dinleme soketindeki bağlantı isteklerinin onAccept etkinliği üzerinden gönderilip gönderilmediğini ya da dinleme sırası yığınında sıraya alınıp alınmadığını gösteren işaret. Şu sayfaya göz atın: setPaused. Varsayılan değer "false" değeridir.

  • inatçı

    boolean

    Uygulamanın etkinlik sayfası kaldırıldığında soketin açık kalıp kalmadığını gösteren işaret (bkz. SocketProperties.persistent). Varsayılan değer "false" (yanlış) değeridir.

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • uuid

    string isteğe bağlı

    Temel yuva bağlıysa bağlı olduğu hizmet UUID'si ile ilgili bilgileri içerir, aksi takdirde temel yuva dinliyorsa dinlediği hizmet UUID'si hakkında bilgiler içerir.

SocketProperties

Özellikler

  • bufferSize

    numara isteğe bağlı

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

  • ad

    string isteğe bağlı

    Yuvayla ilişkilendirilmiş, uygulama tanımlı bir dize.

  • inatçı

    boole isteğe bağlı

    Uygulamanın etkinlik sayfası kaldırıldığında soketin açık kalıp kalmadığını gösteren işaret (Uygulama Yaşam Döngüsünü Yönetme bölümüne bakın). Varsayılan değer false. şeklindedir. Uygulama yüklendiğinde, daha önce kalıcı=doğru ile açılmış olan tüm yuvalar getSockets ile getirilebilir.

Yöntemler

close()

Söz 
chrome.bluetoothSocket.close(
  socketId: number,
  callback?: function,
)

Yuvanın bağlantısını keser ve yuvayı yok eder. Oluşturulan her yuva kullanıldıktan sonra kapatılmalıdır. İşlev çağrıldığı anda yuva kimliği artık geçerli değildir. Ancak yalnızca geri çağırma çağrıldığında yuvanın kapatılması garanti edilir.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

connect()

Söz 
chrome.bluetoothSocket.connect(
  socketId: number,
  address: string,
  uuid: string,
  callback?: function,
)

Yuvayı uzak bir Bluetooth cihazına bağlar. connect işlemi başarıyla tamamlandığında, eşten veri alındığında onReceive etkinlik yükseltilir. Çalışma zamanı paketleri alırken bir ağ hatası oluşursa bir onReceiveError etkinliği oluşturulur. Bu noktada, setPaused(false) yöntemi çağrılana kadar bu yuva için başka onReceive etkinliği oluşturulmaz.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • adres

    dize

    Bluetooth cihazının adresi.

  • uuid

    dize

    Bağlanılacak hizmetin UUID'si.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

create()

Söz 
chrome.bluetoothSocket.create(
  properties?: SocketProperties,
  callback?: function,
)

Bluetooth yuvası oluşturur.

Parametreler

  • mülkler

    SocketProperties isteğe bağlı

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

  • geri çağırma

    Functions (isteğe bağlı)

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

    (createInfo: CreateInfo)=>void

    • createInfo

      CreateInfo

      Yuva oluşturma işleminin sonucu.

İlerlemeler

  • Promise<CreateInfo>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

disconnect()

Söz 
chrome.bluetoothSocket.disconnect(
  socketId: number,
  callback?: function,
)

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

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getInfo()

Söz 
chrome.bluetoothSocket.getInfo(
  socketId: number,
  callback?: function,
)

Belirtilen yuvanın durumunu alır.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (socketInfo: SocketInfo)=>void

    • socketInfo

      SocketInfo

      Yuva bilgilerini içeren nesne.

İlerlemeler

  • Promise<SocketInfo>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getSockets()

Söz 
chrome.bluetoothSocket.getSockets(
  callback?: function,
)

Uygulamanın sahip olduğu, açık durumdaki yuvaların listesini alır.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

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

    (sockets: SocketInfo[])=>void

İlerlemeler

  • Promise<SocketInfo[]>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

listenUsingL2cap()

Söz 
chrome.bluetoothSocket.listenUsingL2cap(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
)

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

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • uuid

    dize

    Dinlenecek UUID hizmeti.

  • seçenekler

    ListenOptions isteğe bağlı

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

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

listenUsingRfcomm()

Söz 
chrome.bluetoothSocket.listenUsingRfcomm(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
)

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

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • uuid

    dize

    Dinlenecek UUID hizmeti.

  • seçenekler

    ListenOptions isteğe bağlı

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

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

send()

Söz 
chrome.bluetoothSocket.send(
  socketId: number,
  data: ArrayBuffer,
  callback?: function,
)

Belirtilen Bluetooth soketinde veri gönderir.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • veri

    ArrayBuffer

    Gönderilecek veriler.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (bytesSent: number)=>void

    • bytesSent

      sayı

      Gönderilen bayt sayısı.

İlerlemeler

  • Vaat<sayı>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

setPaused()

Söz 
chrome.bluetoothSocket.setPaused(
  socketId: number,
  paused: boolean,
  callback?: function,
)

Bağlı bir yuvanın eşinden mesaj almasını etkinleştirir veya devre dışı bırakır ya da bir dinleme yuvasının yeni bağlantıları kabul etmesini sağlar. Varsayılan değer "false" değeridir. Bağlı bir yuvanın duraklatılması, genellikle bir uygulama tarafından, eşi tarafından gönderilen verileri daraltmak için kullanılır. Bağlı bir yuva duraklatıldığında onReceiveetkinliği yükseltilmez. Bir yuva bağlandığında ve duraklatması kaldırıldığında, mesaj alındığında onReceive etkinlikleri tekrar yükselir. Bir dinleme yuvası duraklatıldığında, iş listesi dolana kadar yeni bağlantılar kabul edilir ve ardından ek bağlantı istekleri reddedilir. onAccept etkinlikleri yalnızca yuvanın duraklatması kaldırıldığında yükseltilir.

Parametreler

  • socketId

    sayı

  • duraklatıldı

    boolean

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

update()

Söz 
chrome.bluetoothSocket.update(
  socketId: number,
  properties: SocketProperties,
  callback?: function,
)

Yuva özelliklerini günceller.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • mülkler

    SocketProperties

    Güncellenecek özellikler.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

Etkinlikler

onAccept

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

Belirli bir yuva için bağlantı kurulduğunda gösterilen etkinlik.

Parametreler

  • geri çağırma

    işlev

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

    (info: AcceptInfo)=>void

onAcceptError

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

Çalışma zamanı belirtilen yuvada yeni bağlantıları beklerken bir ağ hatası oluştuğunda etkinlik oluşuyordu. Bu etkinlik yükseltildiğinde, yuva paused olarak ayarlanır ve bu yuva için başka onAccept etkinliği yükseltilmez.

Parametreler

onReceive

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

Belirli bir yuva için veri alındığında ortaya çıkan etkinlik.

Parametreler

  • geri çağırma

    işlev

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

    (info: ReceiveInfo)=>void

onReceiveError

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

Çalışma zamanı yuvada veri beklerken bir ağ hatası oluştuğunda ortaya çıkan etkinlik. Bu etkinlik yükseltildiğinde, yuva paused olarak ayarlanır ve bu yuva için başka onReceive etkinliği yükseltilmez.

Parametreler