How to Configure Access Point Name (APN) Settings: Difference between revisions

From wizarPOS
m (Simon moved page How to set APN to How to Configure Access Point Name (APN) Settings: Normalize the title)
No edit summary
Line 56: Line 56:
|-
|-
| MVNOMatchData ||  '''String:'''  
| MVNOMatchData ||  '''String:'''  
|}
{|
|-
| 
|}
{|class="wizarpostable"
|-
|-
!  scope="row" colspan="2" | Returns
!  scope="row" colspan="2" | Returns
Line 79: Line 73:
|-
|-
| apn ||  '''String:'''  Not null.
| apn ||  '''String:'''  Not null.
|}
{|
|-
| 
|}
{|class="wizarpostable"
|-
|-
!  scope="row" colspan="2" | Returns
!  scope="row" colspan="2" | Returns
Line 107: Line 95:
|-
|-
| mnc ||  '''String:'''  Not null.
| mnc ||  '''String:'''  Not null.
|}
{|
|-
| 
|}
{|class="wizarpostable"
|-
|-
!  scope="row" colspan="2" | Returns
!  scope="row" colspan="2" | Returns
Line 129: Line 111:
|-
|-
| name|| '''String:''' Not null.
| name|| '''String:''' Not null.
|}
{|
|-
| 
|}
{|class="wizarpostable"
|-
|-
!  scope="row" colspan="2" | Returns
!  scope="row" colspan="2" | Returns

Revision as of 20:16, 5 January 2024

The system provides the AIDL interface to set the APN. The package name is com.wizarpos.wizarviewagentassistant, and the class name is com.wizarpos.wizarviewagentassistant.APNManagerService. When the application uses the interface, it must import the package and add permissions to the Android manifest file. 

 Please note that:
 
 * Insert SIM card first
 * The MCC, MNC should be the same as SIM card inserted

Permission

The application declares the following permissions in the manifest： 

 com.wizarpos.permission.WRITE_APN_SETTINGS

API Overview

AddByAllArgs

String addByAllArgs(String name, String apn, String mcc, String mnc, String proxy, String port, String MMSProxy, String MMSPort, String userName, String server, String password, String MMSC, String authType, String protocol, String roamingProtocol, String type, String bearer, String MVNOType, String MVNOMatchData);

Add an APN setting.

Parameters
name String: Not null.
apn String: Not null.
mcc String: Not null.
mnc String: Not null.
proxy String:
port String:
MMSProxy String:
MMSPort String:
userName String:
server String:
password String:
MMSC String:
authType String: Null(default),PAP,CHAP,PAP/CHAP
protocol String: IPV4(default),IPV6,IPV4/IPV6
roamingProtocol String: IPV4(default),IPV6,IPV4/IPV6
type String: Not null.
bearer String: Null(default),LTE,eHRPD
MVNOType String: Null(default),SPN,IMSI,GID
MVNOMatchData String:
Returns
String "succeed" is success, "error description" is failure.

Add

String add(String name, String apn);

Add an APN setting.

Parameters
name String: Not null.
apn String: Not null.
Returns
String "succeed" is success, "error description" is failure.


AddByMCCAndMNC

String addByMCCAndMNC(String name, String apn, String mcc, String mnc);

Add an APN setting.

Parameters
name String: Not null.
apn String: Not null.
mcc String: Not null.
mnc String: Not null.
Returns
String "succeed" is success, "error description" is failure.


SetSelected

boolean setSelected(String name);

Set default APN.

Parameters
name String: Not null.
Returns
boolean true is success, false is failure.

getSelected()

Map getSelected();

Get detail information of the selected APN.

Returns
Map Detail information map.

Snippet code: 

HashMap res = (HashMap)mAPNManagerService.getSelected();
StringBuilder sb = new StringBuilder();
if (res != null) {
sb.append(Telephony.Carriers.NAME + ": ").append(res.get(Telephony.Carriers.NAME) + "\n")
.append(Telephony.Carriers.APN + ": ").append(res.get(Telephony.Carriers.APN) + "\n")
.append(Telephony.Carriers.PROXY + ": ").append(res.get(Telephony.Carriers.PROXY) + "\n")
.append(Telephony.Carriers.PORT + ": ").append(res.get(Telephony.Carriers.PORT) + "\n")
.append(Telephony.Carriers.MMSPROXY + ": ").append(res.get(Telephony.Carriers.MMSPROXY) + "\n")
.append(Telephony.Carriers.MMSPORT + ": ").append(res.get(Telephony.Carriers.MMSPORT) + "\n")
.append(Telephony.Carriers.USER + ": ").append(res.get(Telephony.Carriers.USER) + "\n")
.append(Telephony.Carriers.SERVER + ": ").append(res.get(Telephony.Carriers.SERVER) + "\n")
.append(Telephony.Carriers.MMSC + ": ").append(res.get(Telephony.Carriers.MMSC) + "\n")
.append(Telephony.Carriers.AUTH_TYPE + ": ").append(res.get(Telephony.Carriers.AUTH_TYPE) + "\n")
.append(Telephony.Carriers.PROTOCOL + ": ").append(String.valueOf(res.get(Telephony.Carriers.PROTOCOL)) + "\n")
.append(Telephony.Carriers.ROAMING_PROTOCOL + ": ").append(String.valueOf(res.get(Telephony.Carriers.ROAMING_PROTOCOL)) + "\n")
.append(Telephony.Carriers.TYPE + ": ").append(res.get(Telephony.Carriers.TYPE) + "\n")
.append(Telephony.Carriers.MCC + ": ").append(res.get(Telephony.Carriers.MCC) + "\n")
.append(Telephony.Carriers.MNC + ": ").append(res.get(Telephony.Carriers.MNC) + "\n")
.append(Telephony.Carriers.BEARER + ": ").append(res.get(Telephony.Carriers.BEARER) + "\n")
.append("mvno_type: ").append(String.valueOf(res.get("mvno_type")).toUpperCase() + "\n")
.append("mvno_match_data: ").append(res.get("mvno_match_data"));
}

Clear

boolean clear();

Clear all APN settings.

Returns
boolean true is success, false is failure.


Download

AIDL file

Please download the aidl file

Demo

Please download the bind service demo

Retrieved from "http://sdkwiki.wizarpos.com/index.php?title=How_to_Configure_Access_Point_Name_(APN)_Settings&oldid=3833"