gecko-dev/dom/bluetooth2/BluetoothManager.h

148 lines
4.4 KiB
C++

/* -*- Mode: c++; c-basic-offset: 2; indent-tabs-mode: nil; tab-width: 40 -*- */
/* vim: set ts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_dom_bluetooth_bluetoothmanager_h__
#define mozilla_dom_bluetooth_bluetoothmanager_h__
#include "BluetoothCommon.h"
#include "mozilla/Attributes.h"
#include "mozilla/dom/BluetoothAdapterEvent.h"
#include "mozilla/dom/BluetoothAttributeEvent.h"
#include "mozilla/DOMEventTargetHelper.h"
#include "mozilla/Observer.h"
#include "nsISupportsImpl.h"
BEGIN_BLUETOOTH_NAMESPACE
class BluetoothAdapter;
class BluetoothValue;
class BluetoothManager : public DOMEventTargetHelper
, public BluetoothSignalObserver
{
public:
NS_DECL_ISUPPORTS_INHERITED
/****************************************************************************
* Event Handlers
***************************************************************************/
IMPL_EVENT_HANDLER(attributechanged);
IMPL_EVENT_HANDLER(adapteradded);
IMPL_EVENT_HANDLER(adapterremoved);
/****************************************************************************
* Methods (Web API Implementation)
***************************************************************************/
/**
* Return default adapter if it exists, nullptr otherwise. The function is
* called when applications access property BluetoothManager.defaultAdapter
*/
BluetoothAdapter* GetDefaultAdapter();
/**
* Return adapters array. The function is called when applications call
* method BluetoothManager.getAdapters()
*
* @param aAdapters [out] Adapters array to return
*/
void GetAdapters(nsTArray<nsRefPtr<BluetoothAdapter> >& aAdapters);
/****************************************************************************
* Others
***************************************************************************/
// Never returns null
static already_AddRefed<BluetoothManager> Create(nsPIDOMWindow* aWindow);
static bool CheckPermission(nsPIDOMWindow* aWindow);
void Notify(const BluetoothSignal& aData); // BluetoothSignalObserver
nsPIDOMWindow* GetParentObject() const
{
return GetOwner();
}
virtual JSObject* WrapObject(JSContext* aCx) MOZ_OVERRIDE;
virtual void DisconnectFromOwner() MOZ_OVERRIDE;
/**
* Create a BluetoothAdapter object based on properties array
* and append it into adapters array.
*
* @param aValue [in] Properties array to create BluetoothAdapter object
*/
void AppendAdapter(const BluetoothValue& aValue);
private:
BluetoothManager(nsPIDOMWindow* aWindow);
~BluetoothManager();
/**
* Start/Stop listening to bluetooth signal.
*
* @param aStart [in] Whether to start or stop listening to bluetooth signal
*/
void ListenToBluetoothSignal(bool aStart);
/**
* Check whether default adapter exists.
*/
bool DefaultAdapterExists()
{
return (mDefaultAdapterIndex >= 0);
}
/**
* Handle "AdapterAdded" bluetooth signal.
*
* @param aValue [in] Properties array of the added adapter
*/
void HandleAdapterAdded(const BluetoothValue& aValue);
/**
* Handle "AdapterRemoved" bluetooth signal.
*
* @param aValue [in] Address of the removed adapter
*/
void HandleAdapterRemoved(const BluetoothValue& aValue);
/**
* Re-select default adapter from adapters array. The function is called
* when an adapter is added/removed.
*/
void ReselectDefaultAdapter();
/**
* Fire BluetoothAdapterEvent to trigger
* onadapteradded/onadapterremoved event handler.
*
* @param aType [in] Event type to fire
* @param aInit [in] Event initialization value
*/
void DispatchAdapterEvent(const nsAString& aType,
const BluetoothAdapterEventInit& aInit);
/**
* Fire BluetoothAttributeEvent to trigger onattributechanged event handler.
*/
void DispatchAttributeEvent();
/****************************************************************************
* Variables
***************************************************************************/
/**
* The index of default adapter in the adapters array.
*/
int mDefaultAdapterIndex;
/**
* The adapters array.
*/
nsTArray<nsRefPtr<BluetoothAdapter> > mAdapters;
};
END_BLUETOOTH_NAMESPACE
#endif