From: teakeun.kang Date: Wed, 27 May 2015 01:16:19 +0000 (+0900) Subject: [Web Device API] Add and modify descriptions to sync tizen 2.3.1 X-Git-Tag: tizen_3.0/TD_SYNC/20161201~791 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=274b460153d100aa285cab1c51a945300399dcf7;p=sdk%2Fonline-doc.git [Web Device API] Add and modify descriptions to sync tizen 2.3.1 Change-Id: I05a246f981a9153789d577f203337f401b03dfbd Signed-off-by: teakeun.kang --- diff --git a/org.tizen.guides/html/web/tizen/communication/nfc_w.htm b/org.tizen.guides/html/web/tizen/communication/nfc_w.htm index 8cdbfa1..d8747c2 100644 --- a/org.tizen.guides/html/web/tizen/communication/nfc_w.htm +++ b/org.tizen.guides/html/web/tizen/communication/nfc_w.htm @@ -192,4 +192,4 @@ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga - \ No newline at end of file + diff --git a/org.tizen.tutorials/html/web/tizen/communication/nfc_tutorial_w.htm b/org.tizen.tutorials/html/web/tizen/communication/nfc_tutorial_w.htm index 8754265..b9ac7e2 100644 --- a/org.tizen.tutorials/html/web/tizen/communication/nfc_tutorial_w.htm +++ b/org.tizen.tutorials/html/web/tizen/communication/nfc_tutorial_w.htm @@ -389,4 +389,4 @@ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga - \ No newline at end of file + diff --git a/org.tizen.tutorials/index.xml b/org.tizen.tutorials/index.xml index 9c2393f..907036a 100644 --- a/org.tizen.tutorials/index.xml +++ b/org.tizen.tutorials/index.xml @@ -13,8 +13,8 @@ - - + + diff --git a/org.tizen.web.apireference/html/device_api/mobile/tizen/nfc.html b/org.tizen.web.apireference/html/device_api/mobile/tizen/nfc.html index fb85dd0..354419e 100644 --- a/org.tizen.web.apireference/html/device_api/mobile/tizen/nfc.html +++ b/org.tizen.web.apireference/html/device_api/mobile/tizen/nfc.html @@ -741,6 +741,9 @@ To be allowed to change cardEmulationMode, the following privilege mu

Remark : To check if NFC card emulation is supported on this device, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.nfc.card_emulation").
If it is not supported, NotSupportedError is thrown. +

Security level can be determined by the manufacturer usage. +
If a security issue is occurred, contact with the manufacturer of the product. +
If you want to know about security level in detail, See the GSMA specification.

Exceptions:

@@ -791,6 +794,9 @@ If the NFC service is not available, it returns null.

Remark : To check if NFC card emulation is supported on this device, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.nfc.card_emulation").
If it is not supported, NotSupportedError is thrown. +

Security level can be determined by the manufacturer usage. +
If a security issue is occurred, contact with the manufacturer of the product. +
If you want to know about security level in detail, See the GSMA specification.

Exceptions:

@@ -827,7 +833,7 @@ If the NFC service is not available, it returns null. Sets the power of an NFC adapter to either an on state or an off state.

Deprecated. - It is deprecated since Tizen 2.3 and will be removed in Tizen 3.0. Instead, let the user turn NFC on/off through the Settings application. See the NFC Tutorial. + It is deprecated since Tizen 2.3 and will be removed in Tizen 3.0. Instead, let the user turn NFC on/off through the Settings application. See the Managing NFC Tutorial.

void setPowered(boolean state, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
              
@@ -945,6 +951,9 @@ If no tagFilter is passed, it shall consider the default tagFilter, that is to s Privilege: http://tizen.org/privilege/nfc.tag

+

Remark : + http://tizen.org/feature/network.nfc.tag is added since Tizen 2.3.1. to check if NFC tag is supported on this device, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.nfc.tag"). +

Parameters:

    @@ -972,6 +981,9 @@ is not compatible with the expected type for that parameter. with error type ServiceNotAvailableError, if the NFC service is not available.

  • + with error type NotSupportedError, if NFC tag is not supported. +

  • +
  • with error type UnknownError, in any other error case.

@@ -1015,6 +1027,9 @@ invoked when an NFC peer-to-peer target is detected. Privilege: http://tizen.org/privilege/nfc.p2p

+

Remark : + http://tizen.org/feature/network.nfc.p2p is added since Tizen 2.3.1. to check if NFC p2p is supported on this device, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.nfc.p2p"). +

Parameters:

    @@ -1038,6 +1053,9 @@ is not compatible with the expected type for that parameter. with error type ServiceNotAvailableError, if the NFC service is not available.

  • + with error type NotSupportedError, if NFC p2p is not supported. +

  • +
  • with error type UnknownError, in any other error case.

@@ -1075,6 +1093,9 @@ is not compatible with the expected type for that parameter. Privilege: http://tizen.org/privilege/nfc.tag

+

Remark : + http://tizen.org/feature/network.nfc.tag is added since Tizen 2.3.1. to check if NFC tag is supported on this device, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.nfc.tag"). +

Exceptions:

  • WebAPIException
      @@ -1085,6 +1106,9 @@ is not compatible with the expected type for that parameter. with error type ServiceNotAvailableError, if the NFC service is not available.

    • + with error type NotSupportedError, if NFC tag is not supported. +

    • +
    • with error type UnknownError, in any other error case.

    @@ -1132,6 +1156,9 @@ is not compatible with the expected type for that parameter. Privilege: http://tizen.org/privilege/nfc.p2p

    +

    Remark : + http://tizen.org/feature/network.nfc.p2p is added since Tizen 2.3.1. to check if NFC p2p is supported on this device, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.nfc.p2p"). +

    Exceptions:

    • WebAPIException
        @@ -1142,6 +1169,9 @@ is not compatible with the expected type for that parameter. with error type ServiceNotAvailableError, if the NFC service is not available.

      • + with error type NotSupportedError, if NFC p2p is not supported. +

      • +
      • with error type UnknownError, in any other error case.

      @@ -1607,6 +1637,11 @@ Losing priority is always allowed regardless of an application's status. Privilege: http://tizen.org/privilege/nfc.cardemulation

      +

      Remark : + Security level can be determined by the manufacturer usage. +
      If a security issue is occurred, contact with the manufacturer of the product. +
      If you want to know about security level in detail, See the GSMA specification. +

      Parameters:

        @@ -3669,6 +3704,22 @@ To guarantee that the NFC application runs on a device with the NFC feature, dec

        +To guarantee that the NFC application runs on a device with the NFC tag feature, declare the following feature requirements in the config file: +

        +

        +
      • http://tizen.org/feature/network.nfc.tag
      • +
        +
        +

        +

        +To guarantee that the NFC application runs on a device with the NFC p2p feature, declare the following feature requirements in the config file: +

        +

        +
      • http://tizen.org/feature/network.nfc.p2p
      • +
        +
        +

        +

        To guarantee that the NFC card emulation application runs on a device with the NFC card emulation feature, declare the following feature requirements in the config file:

        @@ -3683,7 +3734,7 @@ To guarantee that the NFC host-based card emulation application runs on a device
      • http://tizen.org/feature/network.nfc.card_emulation.hce
      • - For more information, see Application Filtering. + For more information, see Application Filtering.

      4. Full WebIDL

      module NFC {
      diff --git a/org.tizen.web.apireference/html/device_api/mobile/tizen/se.html b/org.tizen.web.apireference/html/device_api/mobile/tizen/se.html
      index f443eda..9e15bd7 100644
      --- a/org.tizen.web.apireference/html/device_api/mobile/tizen/se.html
      +++ b/org.tizen.web.apireference/html/device_api/mobile/tizen/se.html
      @@ -12,6 +12,9 @@
       
      The SecureElement API provides functionality to communicate with applications in several Secure Elements. A Secure Element is a secure smart card chip. It can be a UICC/SIM, an embedded Secure Element, or a Secure SD card that is inserted in a device. +

      +For more information about how to use SecureElement API, see SecureElement Guide. +

      Since: diff --git a/org.tizen.web.apireference/html/device_api/mobile/tizen/sensor.html b/org.tizen.web.apireference/html/device_api/mobile/tizen/sensor.html index 8bdbb2e..df3fbe7 100644 --- a/org.tizen.web.apireference/html/device_api/mobile/tizen/sensor.html +++ b/org.tizen.web.apireference/html/device_api/mobile/tizen/sensor.html @@ -362,6 +362,17 @@ The supported sensor types are hardware-dependent.

      To check if the given Since: 2.3

      +

      + Privilege level: + public +

      +

      + Privilege: + http://tizen.org/privilege/healthinfo +

      +

      Remark : + http://tizen.org/privilege/healthinfo is required only for HRM_RAW type. HRM_RAW is supported since Tizen 2.3.1. +

      Return value:

      SensorType[] All available sensor types @@ -609,7 +620,7 @@ The start() method must be called to turn on the sensor, or the sensor data will Since: 2.3

      - +

      Methods

      @@ -698,7 +709,7 @@ The ErrorCallback method is launched with these error types: Since: 2.3

      - +

      Methods

      @@ -789,7 +800,7 @@ The ErrorCallback method is launched with these error types: Since: 2.3

      - +

      Methods

      @@ -878,7 +889,7 @@ The ErrorCallback method is launched with these error types: Since: 2.3

      - +

      Methods

      @@ -967,7 +978,7 @@ The ErrorCallback method is launched with these error types: Since: 2.3

      - +

      Methods

      @@ -1056,7 +1067,7 @@ The ErrorCallback method is launched with these error types: Since: 2.3.1

      - +

      Methods

      @@ -1172,7 +1183,7 @@ The ErrorCallback method is launched with these error types: Since: 2.3

      - +

      Attributes

      • @@ -1206,7 +1217,7 @@ The ErrorCallback method is launched with these error types: Since: 2.3

        - +

        Attributes

          @@ -1271,7 +1282,7 @@ For increasing the accuracy, wave the device around in the air in figure-eight p Since: 2.3

          - +

          Attributes

          • @@ -1299,7 +1310,7 @@ For increasing the accuracy, wave the device around in the air in figure-eight p Since: 2.3

            - +

            Attributes

            4. Full WebIDL

            module NFC {
            diff --git a/org.tizen.web.apireference/html/device_api/wearable/tizen/notification.html b/org.tizen.web.apireference/html/device_api/wearable/tizen/notification.html
            new file mode 100644
            index 0000000..1c9b8b8
            --- /dev/null
            +++ b/org.tizen.web.apireference/html/device_api/wearable/tizen/notification.html
            @@ -0,0 +1,1165 @@
            +
            +
            +
            +
            +
            +Notification API
            +
            +
            +
            +
            +

            Notification API

            +
            + The Notification API provides a way to notify users of events that happen in an application. +In Tizen Wearable Profile, only icon, title, content, time are guaranteed to be displayed. Some other attributes can be supported additionally depending on the device. +
            +
            +

            +For more information on the Notification features, see Notification Guide. +

            +
            +

            + Since: + 2.3.1 +

            +

            Table of Contents

            + +
            +

            Summary of Interfaces and Methods

            + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
            InterfaceMethod
            NotificationObject
            NotificationManagervoid post (Notification notification)
            + void update (Notification notification)
            + void remove (NotificationId id)
            + void removeAll ()
            + Notification get (NotificationId id)
            + Notification[] getAll ()
            Notification
            StatusNotificationInit
            StatusNotification
            NotificationDetailInfo
            +
            +

            1. Type Definitions

            +
            +

            1.1. NotificationId

            +
            + A notification ID. +
            +
                typedef DOMString NotificationId;
            +

            + Since: + 2.3.1 +

            +
            +
            +

            1.2. NotificationType

            +
            + A notification type. +
            +
                enum NotificationType { "STATUS" };
            +

            + Since: + 2.3.1 +

            +
            +

            +The following notification type is supported: +

            +
              +
            • +STATUS - The posted status notification is displayed on the status bar and the notification tray. +The status notification consists of an icon, title, content, and time. The status notification can have an application control to launch the specific application when selected by the user.
            • +
            +
            +
            +
            +

            1.3. StatusNotificationType

            +
            + A status notification type. +
            +
                enum StatusNotificationType { "SIMPLE", "THUMBNAIL", "ONGOING", "PROGRESS" };
            +

            + Since: + 2.3.1 +

            +
            +

            +The following status notification types are supported: +

            +
              +
            • +SIMPLE - A basic status notification type that is removed automatically when selected by the user. All simple status notifications can be removed by user interaction.
            • +
            • +THUMBNAIL - The thumbnail status notification posts a thumbnail-format notification which includes several thumbnail image paths. +The thumbnail status notification is also removed by user selection. +
            • +
            • +ONGOING - A status notification type that informs the user whether an application is running or not. However, an ongoing status notification should be removed by the application that posted the notification.
            • +
            • +PROGRESS - A status notification that displays information on the progress of a job. However, this status notification should be removed by the application that posted the notification.
            • +
            +
            +
            +
            +

            1.4. NotificationProgressType

            +
            + A notification progress type. +
            +
                enum NotificationProgressType { "PERCENTAGE",  "BYTE" };
            +

            + Since: + 2.3.1 +

            +
            +

            +The following notification progress types are supported: +

            +
              +
            • + "BYTE" - The progress is indicated in bytes.
            • +
            • + "PERCENTAGE" -The progress is indicated in percentage.
            • +
            +
            +
            +
            +
            +

            2. Interfaces

            +
            +

            2.1. NotificationObject

            +
            + Defines what is instantiated by the Tizen object. +
            +
                [NoInterfaceObject] interface NotificationObject {
            +        readonly attribute NotificationManager notification;
            +    };
            +
                Tizen implements NotificationObject;
            +

            + Since: + 2.3.1 +

            +
            +

            +The tizen.notification object allows access to the +Notification API. +

            +
            +
            +
            +

            2.2. NotificationManager

            +
            + Notification manager interface that provides access to the API. +
            +
                [NoInterfaceObject] interface NotificationManager {
            +
            +    void post(Notification notification) raises(WebAPIException);
            +
            +    void update(Notification notification) raises(WebAPIException);
            +
            +    void remove(NotificationId id) raises(WebAPIException);
            +
            +    void removeAll() raises(WebAPIException);
            +
            +    Notification get(NotificationId id) raises(WebAPIException);
            +
            +    Notification[] getAll() raises(WebAPIException);
            +
            +    };
            +

            + Since: + 2.3.1 +

            +
            +

            +The NotificationManager interface provides access to the notification object. +

            +
            +
            +

            Methods

            +
            +
            +post +
            +
            +
            + Posts a notification to display. +
            +
            void post(Notification notification);
            +             
            +

            + Since: + 2.3.1 +

            +

            + Privilege level: + public +

            +

            + Privilege: + http://tizen.org/privilege/notification +

            +
            +

            Parameters:

            +
              +
            • +notification: + A notification to post. +
            • +
            +
            +
            +

            Exceptions:

            +
            • WebAPIException
                +
              • + with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter. +

              • +
              • + with error type InvalidValuesError, if any of the input +parameters contain an invalid value. +

              • +
              • + with error type SecurityError, if the application does not have the privilege to call this method. +

              • +
              • + with error type UnknownError, if any other error occurs. +

              • +
              +
            +
            +
            +

            Code example:

             try {
            +      var appControl = new tizen.ApplicationControl(
            +                       "http://tizen.org/appcontrol/operation/create_content",
            +                       null,
            +                       "image/jpg",
            +                       null);
            +      var notificationDict = {
            +                  content : "This is a simple notification.",
            +                  iconPath : "images/image1.jpg",
            +                  soundPath : "music/Over the horizon.mp3",
            +                  vibration : true,
            +                  appControl : appControl};
            +
            +      var notification = new tizen.StatusNotification("SIMPLE",
            +                  "Simple notification", notificationDict);
            +
            +      tizen.notification.post(notification);
            + } catch (err) {
            +      console.log (err.name + ": " + err.message);
            + }
            + 
            +
            +
            +
            +update +
            +
            +
            + Updates a previously posted notification. +
            +
            void update(Notification notification);
            +             
            +

            + Since: + 2.3.1 +

            +

            + Privilege level: + public +

            +

            + Privilege: + http://tizen.org/privilege/notification +

            +
            +

            Parameters:

            +
              +
            • +notification: + A notification to update. +
            • +
            +
            +
            +

            Exceptions:

            +
            • WebAPIException
                +
              • + with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter. +

              • +
              • + with error type InvalidValuesError, if any of the input +parameters contain an invalid value. +

              • +
              • + with error type SecurityError, if the application does not have the privilege to call this method. +

              • +
              • + with error type UnknownError, if any other error occurs. +

              • +
              +
            +
            +
            +

            Code example:

             try {
            +      // Uses a variable for the previously posted notification.
            +      notification.content = "My notification";
            +      tizen.notification.update(notification);
            + } catch (err) {
            +      console.log (err.name + ": " + err.message);
            + }
            + 
            +
            +
            +
            +remove +
            +
            +
            + Removes a previously posted notification. +
            +
            void remove(NotificationId id);
            +             
            +

            + Since: + 2.3.1 +

            +

            + Privilege level: + public +

            +

            + Privilege: + http://tizen.org/privilege/notification +

            +
            +

            Parameters:

            +
              +
            • +id: + A previously posted notification ID to remove. +
            • +
            +
            +
            +

            Exceptions:

            +
            • WebAPIException
                +
              • + with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter. +

              • +
              • + with error type NotFoundError, if NotificationId is not found in the previously posted notification. +

              • +
              • + with error type SecurityError, if the application does not have the privilege to call this method. +

              • +
              • + with error type UnknownError, if any other error occurs. +

              • +
              +
            +
            +
            +

            Code example:

             try {
            +      // Uses a variable for the previously posted notification.
            +      tizen.notification.remove(notification.id);
            + } catch (err) {
            +      console.log (err.name + ": " + err.message);
            + }
            + 
            +
            +
            +
            +removeAll +
            +
            +
            + Removes all notifications that have been posted by the current application. +
            +
            void removeAll();
            +             
            +

            + Since: + 2.3.1 +

            +

            + Privilege level: + public +

            +

            + Privilege: + http://tizen.org/privilege/notification +

            +
            +

            Exceptions:

            +
            • WebAPIException
                +
              • + with error type SecurityError, if the application does not have the privilege to call this method. +

              • +
              • + with error type UnknownError, if any other error occurs. +

              • +
              +
            +
            +
            +

            Code example:

             try {
            +      tizen.notification.removeAll();
            + } catch (err) {
            +      console.log (err.name + ": " + err.message);
            + }
            + 
            +
            +
            +
            +get +
            +
            +
            + Gets a notification that has previously been posted by the current application. Note that the obtained notification's progressType is PERCENTAGE
            + +

            + Since: + 2.3.1 +

            +
            +

            Parameters:

            +
              +
            • +id: + A previously posted notification ID. +
            • +
            +
            +
            +

            Exceptions:

            +
            • WebAPIException
                +
              • + with error type NotFoundError, if NotificationId is not found in the previously posted notifications. +

              • +
              • + with error type UnknownError, if any other error occurs. +

              • +
              +
            +
            +
            +

            Code example:

             try {
            +      // Uses a variable for the previously posted notification
            +      // Saves the notification ID for future use
            +      var myId = notification.id;
            +
            +      var myNotification = tizen.notification.get(myId);
            + } catch (err) {
            +      console.log (err.name + ": " + err.message);
            + }
            + 
            +
            +
            +
            +getAll +
            +
            +
            + Gets all notifications that have previously been posted by the current application. Note that the obtained notification's progressType is PERCENTAGE
            +
            Notification[] getAll();
            +             
            +

            + Since: + 2.3.1 +

            +
            +

            Exceptions:

            +
            • WebAPIException
              • + with error type UnknownError, if any other error occurs. +

              +
            +
            +
            +

            Code example:

             try {
            +     var notifications = tizen.notification.getAll();
            +     var index = 0;
            +
            +     for ( index = 0; index < notifications.length; index++ )
            +     {
            +         console.log(notifications[index].id);
            +         console.log(notifications[index].title);
            +         console.log(notifications[index].statusType);
            +         console.log(notifications[index].type);
            +         console.log(notifications[index].content);
            +         console.log(notifications[index].postedTime);
            +         console.log(notifications[index].iconPath);
            +         console.log(notifications[index].soundPath);
            +         console.log(notifications[index].vibration);
            +         console.log(notifications[index].appControl);
            +     }
            + } catch (err) {
            +     console.log (err.name + ": " + err.message);
            + }
            + 
            +
            +
            +
            +
            +
            +
            +

            2.3. Notification

            +
            + The Notification interface offers common attributes to represent the Notification object. +
            +
                [NoInterfaceObject] interface Notification {
            +
            +
            +    readonly attribute NotificationId id;
            +
            +    readonly attribute NotificationType type;
            +
            +    readonly attribute Date postedTime;
            +
            +    attribute DOMString title;
            +
            +    attribute DOMString? content;
            +
            +    };
            +

            + Since: + 2.3.1 +

            +
            +

            Attributes

            +
              +
            • + readonly +NotificationId id
              + The Notification identifier. Before the notification is posted, this value is undefined. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • + readonly +NotificationType type
              + The Notification type. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • + readonly +Date postedTime
              + The time when the notification is posted. Before the notification is posted, this value is undefined. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString title
              + The title to display in a notification. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString content [nullable]
              + The content to display in a notification. +
              +

              + Since: + 2.3.1 +

              +
            • +
            +
            +
            +
            +

            2.4. StatusNotificationInit

            +
            + The properties of StatusNotification, to pass a constructor. +
            +
                dictionary StatusNotificationInit {
            +        DOMString? content;
            +        DOMString? iconPath;
            +        DOMString? soundPath;
            +        boolean? vibration;
            +        ApplicationControl? appControl;
            +        ApplicationId? appId;
            +        NotificationProgressType? progressType;
            +        unsigned long? progressValue;
            +        long? number;
            +        DOMString? subIconPath;
            +        NotificationDetailInfo[]? detailInfo;
            +        DOMString? ledColor;
            +        unsigned long ledOnPeriod;
            +        unsigned long ledOffPeriod;
            +        DOMString? backgroundImagePath;
            +        DOMString[]? thumbnails;
            +    };
            +

            + Since: + 2.3.1 +

            +
            +
            +

            2.5. StatusNotification

            +
            + The StatusNotification interface represents a status notification and offers additional attributes to represent a notification displayed in the notification tray. +
            +
               [Constructor(StatusNotificationType statusType, DOMString title, optional StatusNotificationInit? notificationInitDict)]
            +
            +
            +    interface StatusNotification : Notification {
            +
            +    readonly attribute StatusNotificationType statusType;
            +
            +    attribute DOMString? iconPath;
            +
            +    attribute DOMString? subIconPath;
            +
            +    attribute long? number;
            +
            +    attribute NotificationDetailInfo[]? detailInfo;
            +
            +    attribute DOMString? ledColor;
            +
            +    attribute unsigned long ledOnPeriod;
            +
            +    attribute unsigned long ledOffPeriod;
            +
            +    attribute DOMString? backgroundImagePath;
            +
            +    attribute DOMString[]? thumbnails;
            +
            +    attribute DOMString? soundPath;
            +
            +    attribute boolean vibration;
            +
            +    attribute ApplicationControl? appControl;
            +
            +    attribute ApplicationId? appId;
            +
            +    attribute NotificationProgressType progressType;
            +
            +    attribute unsigned long? progressValue;
            +    };
            +

            + Since: + 2.3.1 +

            +
            +

            +All notifications must have a title attribute. +

            +
            + +
            +

            Constructors

            +
            StatusNotification(StatusNotificationType statusType, DOMString title, optional StatusNotificationInit? notificationInitDict);
            +
            +
            +

            Attributes

            +
              +
            • + readonly +StatusNotificationType statusType
              + The status notification type. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString iconPath [nullable]
              + The icon path to display in the notification. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString subIconPath [nullable]
              + The sub icon path to display in the notification. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +long number [nullable]
              + The number of events to display in the notification. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +NotificationDetailInfo[] + detailInfo [nullable]
              + Appends lines of the detail information to the notification. +This attribute is available in a simple status notification. +By default, this attribute is initialized with an empty array. +The maximum number of detail information elements in the array is 2. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString ledColor [nullable]
              + Sets the notification LED indicator color property. +The color is a numerical RGB value(#rrggbb). The format of an RGB value in hexadecimal notation is a "#" immediately followed by exactly six hexadecimal characters(0-9, A-F). The color format is case-insensitive. +The LED indicator color will show that it's a close approximation. +LED will only light on when the screen is off. To turn the LED off, set "#000000" or null to ledColor. +This method has effects when the device has notification LED. +
              +

              + Since: + 2.3.1 +

              +
              +

              Code example:

               try {
              +      var notificationDict = {
              +                  content : "This is a simple notification.",
              +                  iconPath : "images/image1.jpg",
              +                  soundPath : "music/Over the horizon.mp3",
              +                  vibration : true,
              +                  ledColor : "#FFFF00",
              +                  ledOnPeriod: 1000,
              +                  ledOffPeriod : 500 };
              +
              +      var notification = new tizen.StatusNotification("SIMPLE",
              +                  "Simple notification", notificationDict);
              +
              +      tizen.notification.post(notification);
              + } catch (err) {
              +      console.log (err.name + ": " + err.message);
              + }
              + 
              +
              +
            • +
            • +unsigned long ledOnPeriod
              + The milliseconds for which the light is on. +The light continuously toggles on (ledOnPeriod) and off (ledOffPeriod). +By default, this attribute is set to 0 +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +unsigned long ledOffPeriod
              + The milliseconds for which the light is off. +By default, this attribute is set to 0. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString backgroundImagePath [nullable]
              + The image path to use as the background of the notification. +This attribute is available on simple or thumbnail status notifications. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString[] + thumbnails [nullable]
              + The image paths associated with the thumbnail status notification. +By default, this attribute is initialized with an empty array. +The maximum number of thumbnail path elements in the array is 4. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString soundPath [nullable]
              + The path of a sound file to play when the notification is shown. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +boolean vibration
              + Checks whether to vibrate when the notification is shown. By default, this attribute is set to false. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +ApplicationControl appControl [nullable]
              + Holds the application control to launch an application when the notification is selected from the notification tray. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +ApplicationId appId [nullable]
              + Holds the application ID to launch when the notification is selected from the notification tray. +
              +

              + Since: + 2.3.1 +

              +
              +

              Code example:

               try {
              +
              +      // Gets the current application information with tizen.application.getAppInfo
              +      var myappInfo = tizen.application.getAppInfo();
              +
              +      var notificationDict = {
              +                  content : "This is a simple notification.",
              +                  iconPath : "images/image1.jpg",
              +                  soundPath : "music/Over the horizon.mp3",
              +                  vibration : true,
              +                  appId : myappInfo.id };
              +
              +      var notification = new tizen.StatusNotification("SIMPLE",
              +                  "Simple notification", notificationDict);
              +
              +      tizen.notification.post(notification);
              + } catch (err) {
              +      console.log (err.name + ": " + err.message);
              + }
              + 
              +
              +
            • +
            • +NotificationProgressType progressType
              + Defines the type for an ongoing notification's progress. +By default, this attribute is set to PERCENTAGE. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +unsigned long progressValue [nullable]
              + Defines the current notification progress value (PERCENTAGE or BYTE), depending on the progressType
              +
              +

              +If progressValue is set, the progressbar will be displayed in the notification. The progressValue can change the amount of progress as it moves forward or backward. It gets the progress value of the current notification. +If 0, the indeterminate progressbar will be shown. +This attribute is only available for StatusNotification of type PROGRESS. +

              +

              +Applications should keep the progress value for its job because +the saved value in the notification status tray would be different from +the exact progress value. +

              +

              +Range of progressValue: percent (0 to 100). +

              +
              +

              + Since: + 2.3.1 +

              +
              +

              Code example:

               try {
              +      var appControl = new tizen.ApplicationControl(
              +      "http://tizen.org/appcontrol/operation/create_content",
              +      null,
              +      "image/jpg",
              +      null);
              +
              +      var notificationDict = {
              +                  content : "This is a progress notification.",
              +                  iconPath : "images/image2.jpg",
              +                  soundPath : "music/Over the horizon.mp3",
              +                  vibration : true,
              +                  appControl : appControl,
              +                  progressValue : 20};
              +      // Constructs the progress notification
              +      var notification = new tizen.StatusNotification("PROGRESS",
              +                         "Progress notification", notificationDict);
              +      // Posts the notification
              +      tizen.notification.post(notification);
              +
              +      // Updates the progress value of the notification
              +      notification.progressValue = 59;
              +      tizen.notification.update(notification);
              +
              +
              + } catch (err) {
              +     console.log (err.name + ": " + err.message);
              + }
              + 
              +
              +
            • +
            +
            +
            +
            +

            2.6. NotificationDetailInfo

            +
            + The NotificationDetailInfo object that contains the detail information of the notification. +
            +
                [Constructor(DOMString mainText, optional DOMString? subText)]
            +    interface NotificationDetailInfo {
            +    attribute DOMString mainText;
            +
            +    attribute DOMString? subText;
            +    };
            +

            + Since: + 2.3.1 +

            +
            +

            Code example:

             var detailInfo1 = new tizen.NotificationDetailInfo('Missed Call from James', 'Feb 11 2013');
            + notification.detailInfo = [detailInfo1];
            +
            +
            +
            +

            Constructors

            +
            NotificationDetailInfo(DOMString mainText, optional DOMString? subText);
            +
            +
            +

            Attributes

            +
              +
            • +DOMString mainText
              + The main content of the detail information. +This attribute is available on simple status notifications. +
              +

              + Since: + 2.3.1 +

              +
            • +
            • +DOMString subText [nullable]
              + The secondary content of the detail information. +
              +
              +

              +By default, this attribute is set to null. +

              +
              +

              + Since: + 2.3.1 +

              +
            • +
            +
            +
            +
            +

            3. Full WebIDL

            +
            module Notification {
            +
            +    typedef DOMString NotificationId;
            +
            +    enum NotificationType { "STATUS" };
            +
            +    enum StatusNotificationType { "SIMPLE", "THUMBNAIL", "ONGOING", "PROGRESS" };
            +
            +    enum NotificationProgressType { "PERCENTAGE",  "BYTE" };
            +
            +
            +    [NoInterfaceObject] interface NotificationObject {
            +        readonly attribute NotificationManager notification;
            +    };
            +    Tizen implements NotificationObject;
            +
            +    [NoInterfaceObject] interface NotificationManager {
            +
            +    void post(Notification notification) raises(WebAPIException);
            +
            +    void update(Notification notification) raises(WebAPIException);
            +
            +    void remove(NotificationId id) raises(WebAPIException);
            +
            +    void removeAll() raises(WebAPIException);
            +
            +    Notification get(NotificationId id) raises(WebAPIException);
            +
            +    Notification[] getAll() raises(WebAPIException);
            +
            +    };
            +
            +
            +    [NoInterfaceObject] interface Notification {
            +
            +
            +    readonly attribute NotificationId id;
            +
            +    readonly attribute NotificationType type;
            +
            +    readonly attribute Date postedTime;
            +
            +    attribute DOMString title;
            +
            +    attribute DOMString? content;
            +
            +    };
            +
            +
            +    dictionary StatusNotificationInit {
            +        DOMString? content;
            +        DOMString? iconPath;
            +        DOMString? soundPath;
            +        boolean? vibration;
            +        ApplicationControl? appControl;
            +        ApplicationId? appId;
            +        NotificationProgressType? progressType;
            +        unsigned long? progressValue;
            +        long? number;
            +        DOMString? subIconPath;
            +        NotificationDetailInfo[]? detailInfo;
            +        DOMString? ledColor;
            +        unsigned long ledOnPeriod;
            +        unsigned long ledOffPeriod;
            +        DOMString? backgroundImagePath;
            +        DOMString[]? thumbnails;
            +    };
            +
            +   [Constructor(StatusNotificationType statusType, DOMString title, optional StatusNotificationInit? notificationInitDict)]
            +
            +
            +    interface StatusNotification : Notification {
            +
            +    readonly attribute StatusNotificationType statusType;
            +
            +    attribute DOMString? iconPath;
            +
            +    attribute DOMString? subIconPath;
            +
            +    attribute long? number;
            +
            +    attribute NotificationDetailInfo[]? detailInfo;
            +
            +    attribute DOMString? ledColor;
            +
            +    attribute unsigned long ledOnPeriod;
            +
            +    attribute unsigned long ledOffPeriod;
            +
            +    attribute DOMString? backgroundImagePath;
            +
            +    attribute DOMString[]? thumbnails;
            +
            +    attribute DOMString? soundPath;
            +
            +    attribute boolean vibration;
            +
            +    attribute ApplicationControl? appControl;
            +
            +    attribute ApplicationId? appId;
            +
            +    attribute NotificationProgressType progressType;
            +
            +    attribute unsigned long? progressValue;
            +    };
            +
            +    [Constructor(DOMString mainText, optional DOMString? subText)]
            +    interface NotificationDetailInfo {
            +    attribute DOMString mainText;
            +
            +    attribute DOMString? subText;
            +    };
            +
            +};
            +
            + + + diff --git a/org.tizen.web.apireference/html/device_api/wearable/tizen/sensor.html b/org.tizen.web.apireference/html/device_api/wearable/tizen/sensor.html index 5b69862..fe21173 100644 --- a/org.tizen.web.apireference/html/device_api/wearable/tizen/sensor.html +++ b/org.tizen.web.apireference/html/device_api/wearable/tizen/sensor.html @@ -362,6 +362,17 @@ The supported sensor types are hardware-dependent.

            To check if the given Since: 2.3

            +

            + Privilege level: + public +

            +

            + Privilege: + http://tizen.org/privilege/healthinfo +

            +

            Remark : + http://tizen.org/privilege/healthinfo is required only for HRM_RAW type. HRM_RAW is supported since Tizen 2.3.1. +

            Return value:

            SensorType[] All available sensor types diff --git a/org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo_capability_keys.html b/org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo_capability_keys.html index 66909d0..c519d76 100755 --- a/org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo_capability_keys.html +++ b/org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo_capability_keys.html @@ -869,11 +869,23 @@ Tizen
            --> -http://tizen.org/feature/network.nfc - boolean - The platform returns true for this key, if the device supports NFC API which requires Near Field Communication (NFC). - 2.2.1 - + http://tizen.org/feature/network.nfc + boolean + The platform returns true for this key, if the device supports NFC API which requires Near Field Communication (NFC). + 2.2.1 + + + http://tizen.org/feature/network.nfc.p2p + boolean + The platform returns true for this key, if the device supports P2P APIs which require Near Field Communication (NFC). + 2.3.1 + + + http://tizen.org/feature/network.nfc.tag + boolean + The platform returns true for this key, if the device supports Tag APIs which require Near Field Communication (NFC). + 2.3.1 + http://tizen.org/feature/network.nfc.card_emulation boolean diff --git a/org.tizen.web.apireference/index.xml b/org.tizen.web.apireference/index.xml index 76a203c..571011a 100644 --- a/org.tizen.web.apireference/index.xml +++ b/org.tizen.web.apireference/index.xml @@ -113,6 +113,7 @@ +