gecko/dom/webidl/MozNFC.webidl

117 lines
3.1 KiB
Plaintext

/* 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/. */
/* Copyright © 2013 Deutsche Telekom, Inc. */
enum NfcErrorMessage {
"",
"IOError",
"Timeout",
"Busy",
"ErrorConnect",
"ErrorDisconnect",
"ErrorRead",
"ErrorWrite",
"InvalidParameter",
"InsufficientResource",
"ErrorSocketCreation",
"FailEnableDiscovery",
"FailDisableDiscovery",
"NotInitialize",
"InitializeFail",
"DeinitializeFail",
"NotSupport",
"FailEnableLowPowerMode",
"FailDisableLowPowerMode"
};
[NoInterfaceObject]
interface MozNFCManager {
/**
* API to check if the given application's manifest
* URL is registered with the Chrome Process or not.
*
* Returns success if given manifestUrl is registered for 'onpeerready',
* otherwise error
*/
[CheckPermissions="nfc-manager", AvailableIn=CertifiedApps]
Promise<boolean> checkP2PRegistration(DOMString manifestUrl);
/**
* Notify that user has accepted to share nfc message on P2P UI
*/
[CheckPermissions="nfc-manager", AvailableIn=CertifiedApps]
void notifyUserAcceptedP2P(DOMString manifestUrl);
/**
* Notify the status of sendFile operation
*/
[CheckPermissions="nfc-manager", AvailableIn=CertifiedApps]
void notifySendFileStatus(octet status, DOMString requestId);
/**
* Power on the NFC hardware and start polling for NFC tags or devices.
*/
[CheckPermissions="nfc-manager", AvailableIn=CertifiedApps]
Promise<void> startPoll();
/**
* Stop polling for NFC tags or devices. i.e. enter low power mode.
*/
[CheckPermissions="nfc-manager", AvailableIn=CertifiedApps]
Promise<void> stopPoll();
/**
* Power off the NFC hardware.
*/
[CheckPermissions="nfc-manager", AvailableIn=CertifiedApps]
Promise<void> powerOff();
};
[JSImplementation="@mozilla.org/navigatorNfc;1",
NavigatorProperty="mozNfc",
Func="Navigator::HasNFCSupport",
CheckPermissions="nfc nfc-share",
AvailableIn="PrivilegedApps"]
interface MozNFC : EventTarget {
/**
* This event will be fired when another NFCPeer is detected, and user confirms
* to share data to the NFCPeer object by calling mozNFC.notifyUserAcceptedP2P.
* The event will be type of NFCPeerEvent.
*/
[CheckPermissions="nfc-share", AvailableIn=CertifiedApps]
attribute EventHandler onpeerready;
/**
* This event will be fired when a NFCPeer is detected.
*/
attribute EventHandler onpeerfound;
/**
* This event will be fired when NFCPeer, earlier detected in onpeerready
* or onpeerfound, moves out of range.
*/
attribute EventHandler onpeerlost;
/**
* Ths event will be fired when a NFCTag is detected.
*/
attribute EventHandler ontagfound;
/**
* This event will be fired if the tag detected in ontagfound has been removed.
*/
attribute EventHandler ontaglost;
};
// Mozilla Only
partial interface MozNFC {
[ChromeOnly]
void eventListenerWasAdded(DOMString aType);
[ChromeOnly]
void eventListenerWasRemoved(DOMString aType);
};
MozNFC implements MozNFCManager;