Version: Smart Feature Phone 3.0

navigator.b2g.dataCallManager

Description#

The dataCallManager allow application who has the "datacall" permission to control the specific data connection for packet transfer purpose.

Interfaces#

/**
   * Request data call for a certain data call type.
   *
   * @param type
   *        The desired data call type, one of the DataCallType values.
   * @param serviceId [optional]
   *        Default value is the user setting service id for data call.
   *
   * @return If success, promise is resolved with the new created DataCall
             object. Otherwise, rejected with an error message.
   */
  Promise<DataCall> requestDataCall(DataCallType type,
                                    optional unsigned long serviceId);

  /**
   * Request the current state of a certain data call type.
   *
   * @param type
   *        The desired data call type, one of the DataCallType values.
   * @param serviceId [optional]
   *        Default value is the user setting service id for data call.
   *
   * @return If success, promise is resolved with a DataCallState. Otherwise,
   *         rejected with an error message.
   */
  Promise<DataCallState> getDataCallState(DataCallType type,
                                          optional unsigned long serviceId);

Interface Params#

DataCallType

The desired data call type.

enum DataCallType {
  "default",
  "mms",
  "supl",
  "ims",
  "dun",
  "fota",
  "hipri",
  "xcap",
  "cbs",
  "Emergency"
};

DataCallState

enum DataCallState {
  "unknown",
  "connecting",
  "connected",
  "disconnecting",
  "disconnected",
  "unavailable"
};

Examples#

navigator.b2g.dataCallManager.requestDataCall("mms",0)
.then((aDataCall) => {
    console.log("requestDataCall success");
}, (aError) => {
    console.log("requestDataCall error=" + aError);
});