chrome.bluetoothSocket

Açıklama

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

Manifest

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

"bluetooth"

Türler

AcceptError

Enum

"system_error"
Sistem hatası oluştu. Bağlantı kurtarılamayabilir.

"not_listening"
Yuva 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ı (ö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 soketinin başlangıçta duraklatıldığını ve veri almaya başlaması için uygulama tarafından duraklatmanı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 gibi diğer API'lerden oluşturulan yuva kimlikleriyle uyumlu olmadığını unutmayın.

ListenOptions

Özellikler

  • iş listesi

    sayı 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

    sayı 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

    sayı isteğe bağlı

    listenUsingL2cap tarafından kullanılan L2CAP PSM. Belirtilirse bu PSM'nin daha önce kullanılmaması veya başarısız olan yöntem çağrısının olmaması gerekir. Belirtilmediğinde, kullanılmayan bir PSM otomatik olarak ayrılır.

ReceiveError

Enum

"disconnected"
Bağlantı kesildi.

"system_error"
Sistem hatası oluştu. Bağlantı kurtarılamayabilir.

"not_connected"
Yuva bağlanmadı.

ReceiveErrorInfo

Özellikler

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

  • errorMessage

    dize

    Hata mesajı.

  • socketId

    sayı

    Yuva tanımlayıcısı.

ReceiveInfo

Özellikler

  • veri

    DiziArabelleği

    Maksimum bufferSize boyutunda olmak üzere alınan veriler.

  • socketId

    sayı

    Yuva tanımlayıcısı.

SocketInfo

Özellikler

  • adres

    dize isteğe bağlı

    Temel soket bağlıysa, bağlı olduğu cihazın Bluetooth adresini içerir.

  • bufferSize

    sayı isteğe bağlı

    Verileri almak için kullanılan arabelleğin boyutu. Açık bir şekilde arabellek boyutu belirtilmediyse değer sağlanmaz.

  • bağlandı

    boolean

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

  • ad

    dize isteğe bağlı

    Yuva ile ilişkili, uygulama tanımlı dize.

  • duraklatıldı

    boolean

    Bağlı bir yuvanın, eşinin daha fazla veri göndermesini engelleyip engellemediğini veya bir dinleme yuvasındaki bağlantı isteklerinin onAccept etkinliği aracılığıyla mı gönderildiğini ya da dinleme sırası iş listesinde sıraya alınıp alınmadığını gösteren işaret. Şu sayfaya göz atın: setPaused. Varsayılan değer "false" (yanlış) değeridir.

  • kalıcı

    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

    dize isteğe bağlı

    Temel yuva bağlıysa, bağlı olduğu hizmet UUID'si hakkında bilgi içerir. Aksi takdirde, temel soket dinlemedeyse dinlemede kullandığı hizmet UUID'si hakkında bilgi içerir.

SocketProperties

Özellikler

  • bufferSize

    sayı isteğe bağlı

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

  • ad

    dize isteğe bağlı

    Yuva ile ilişkili, uygulama tanımlı bir dize.

  • kalıcı

    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ü Yönetme sayfasına bakın). Varsayılan değer false.: Uygulama yüklendiğinde, daha önce kalıcı=true ile açılan tüm yuvalar getSockets ile alınabilir.

Yöntemler

close()

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

Soketin bağlantısını keser ve soketi yok eder. Oluşturulan her yuva kullanımdan sonra kapatılmalıdır. İşlev çağrıldığı anda yuva kimliği geçerli olmaz. Ancak yuvanın yalnızca geri arama çağrıldığında kapatılacağı garanti edilir.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

connect()

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

Soketi uzak Bluetooth cihazına bağlar. connect işlemi başarıyla tamamlandığında, eşten veri alındığında onReceive etkinlik oluşturulur. Ç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 onReceive etkinliği tetiklenmez.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • adres

    dize

    Bluetooth cihazın adresi.

  • Uuid

    dize

    Bağlanılacak hizmetin UUID'si.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

create()

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

Bluetooth soketi oluşturur.

Parametreler

  • mülkler

    SocketProperties isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

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

    (createInfo: CreateInfo) => void

    • createInfo

      CreateInfo

      Yuvanın oluşturulmasının sonucu.

İadeler

  • Promise&lt;CreateInfo&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

disconnect()

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

Prizin bağlantısını keser. Yuva kimliği geçerli kalır.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getInfo()

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

Belirli bir yuvanın durumunu alır.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • geri çağırma

    işlev isteğe bağlı

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

    (socketInfo: SocketInfo) => void

    • socketInfo

      SocketInfo

      Yuva bilgilerini içeren nesne.

İadeler

  • Promise&lt;SocketInfo&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getSockets()

Söz 'nı inceleyin.
chrome.bluetoothSocket.getSockets(
  callback?: function,
)

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (sockets: SocketInfo[]) => void

İadeler

  • Promise&lt;SocketInfo[]&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

listenUsingL2cap()

Söz 'nı inceleyin.
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 hizmet UUID'si.

  • seçenekler

    ListenOptions isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

listenUsingRfcomm()

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

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

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • Uuid

    dize

    Dinlenecek hizmet UUID'si.

  • seçenekler

    ListenOptions isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

send()

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

Belirtilen Bluetooth soketindeki verileri gönderir.

Parametreler

  • socketId

    sayı

    Yuva tanımlayıcısı.

  • veri

    DiziArabelleği

    Gönderilecek veriler.

  • geri çağırma

    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&lt;number&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setPaused()

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

Bağlı bir soketin, eşinden ileti 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" (yanlış) değeridir. Bağlı bir yuvanın duraklatılması, genellikle bir uygulama tarafından eşi tarafından gönderilen verileri kısıtlamak için kullanılır. Bağlı bir yuva duraklatıldığında herhangi bir onReceiveetkinliği oluşturulmaz. Bir yuva bağlandığında ve duraklatma kaldırıldığında, mesajlar alındığında onReceive etkinlikleri tekrar tetiklenir. Bir dinleme soketi duraklatıldığında, iş listesi dolana kadar yeni bağlantılar kabul edilir, ardından ek bağlantı istekleri reddedilir. onAccept etkinlikleri, yalnızca yuva duraklatma işlemi kaldırıldığında ortaya çıkar.

Parametreler

  • socketId

    sayı

  • duraklatıldı

    boolean

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

update()

Söz 'nı inceleyin.
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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

Etkinlikler

onAccept

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

Belirli bir yuva için bağlantı kurulduğunda ortaya çıkan 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 ortaya çıkan etkinlik. Bu etkinlik oluşturulduktan sonra yuva paused olarak ayarlanır ve bu yuva için başka onAccept etkinliği oluşturulmaz.

Parametreler

onReceive

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

Belirli bir yuva için veri alındığında oluşturulan 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 oluşturulduktan sonra yuva paused olarak ayarlanır ve bu yuva için başka onReceive etkinliği oluşturulmaz.

Parametreler