7.5 KiB
Integrating and Configuring PenNavUI
5. Run the Plug & Play (P&P) Module
To implement the PenNavUIDelegate interface in your Java project and begin calling the P&P functions, follow this steps:
-
From your project implement the PenNavUIDelegate to start calling the P&P functions
public class MyClass implements PenNavUIDelegate {} -
In the class where you implement the PenNavUIDelegate interface, you need to call three functions :
a. onPenNavSuccess : The triggering of this callback signifies the successful initialization of the P&P module.
@Override public void onPenNavSuccess(String warning) {}b. onPenNavInitializationError : callback is triggered upon the failure of the P&P module initialization process.
@Override public void onPenNavInitializationError(String description, InitializationErrorType errorType) {}c. onPenNavUIDismiss : callback is triggered upon the successful closure of the P&P module, which is initiated by the clicking of the back button.
@Override public void onPenNavUIDismiss() {} -
Setup the P&P configuration using PlugAndPlayConfiguration.Builder
private PlugAndPlayConfiguration.Builder builder=new PlugAndPlayConfiguration.Builder(); -
From the class that used to start the P&P module,setup the P&P configurations
There are two types of configurations (mandatory and optional).
a. Mandatory configuration : if these configurations are not setup , the P&P module initialization will fail
PlugAndPlaySDK.configuration = builder .setBaseUrl(dataServerUrl, positionServerUrl) .setServiceName(dataServiceName,positionServiceName) .setClientData(clientID, clientKey) .setUserName(name)Config Link setBaseUrl description setServiceName description setClientData description setUserName description b. And other optional configurations, you have the option to add them or ignore them and it will not affect the app performance
builder.setSimulationModeEnabled(isSimulation) .setLanguageID(languageCode) .setCustomizeColor(hexCode) .setDeepLinkSchema(deepLinkSchema) .setDeepLinkData(deepLinkReceivedData)Config Link setSimulationModeEnabled description setLanguageID description setCustomizeColor description setDeepLinkData description setDeepLinkSchema description
After Setting configuration
You need to build the configuration
builder.build()
Start initializing our SDK
Call the initialize(Context, PenNavUIDelegate) method providing an object that implements PenNavUIDelegate.
PlugAndPlaySDK.start(Context,PenNavUIDelegate);
6. Possibly another implementation is needed
1. Implementing the Off Location Campus Delegate
In this callBack if the user is offCampus you can get the location as (Latitude and Longitude)
Take the following steps to get notified if the user location is off-campus:
-
From your project Implement the
PILocationDelegateinterface and itsonLocationOffCampus(ArrayList<Double> location)method that gets called back when the user location is off-campus with an array of floating-point numbers as a parameter that represents off-campus latitude and longitude.public class MyClass extends AppCompatActivity implements PILocationDelegate -
In the class where you implement the PILocationDelegate interface, you can call one method
public class MyClass extends AppCompatActivity implements PILocationDelegate { @Override public void onLocationOffCampus(ArrayList<Double> location) {} }You will receive an arrayList of double points of Latitude and longitude
Example of how you can use the data :
if (location.size() > 0) Toast.makeText(mContext , "Location Info Latitude : " + location.get(0) + " longitude : " + location.get(1) , Toast.LENGTH_SHORT).show();And the data will shown as :
Location Info Latitude : 31.656546 longitude : 35.46146
-
During the map initializing step, set the
PILocationDelegatein thesetPiLocationDelegatemethod to an object that implements thePILocationDelegateinterface and itsArrayList<Double> location)method.
PlugAndPlaySDK.setPiLocationDelegate(PILocationDelegate);
2. Navigating to Places on the Map
Using Reference IDs
You can use this method From PlugAndPlaySDK class and use it if you want to show the Poi on the map and navigate to it
Call the navigateTo(Context mContext, String referenceID, Completion completion) method to
navigate to a place given its reference ID.
PlugAndPlaySDK.navigateTo(Context,String,Completion)
Using shared Links
- Provide a shared link for plug-and-play to share user or Poi location on the map using
the
setDeepLinkSchema(String)methodPlugAndPlayConfiguration.Builder().setDeepLinkSchema(String) - Provide data from a deep link to display places on the map using the
setDeepLinkData(String)methodPlugAndPlayConfiguration.Builder().setDeepLinkData(String)
3. Reporting an Issue
The PlugAndPlaySDK provides a flexible way to capture and report issues within your application. By using a delegate, you can seamlessly integrate third-party tools or your end point to streamline the process of issue reporting and debugging.
Setting Up the Delegate
To enable issue reporting with PlugAndPlaySDK, you need to set up a delegate by calling the setPiEventsDelegate method. The delegate is responsible for handling issue reports. Here's the basic setup:
PlugAndPlaySDK.setPiEventsDelegate(new PIEventsDelegate() {
@Override
public void onReportIssue(PIReportIssue issue) {
// Implement issue reporting logic here
}
});
In this code snippet, we define an anonymous inner class that implements the PIEventsDelegate interface. The onReportIssue method is where you will place the logic for reporting issues to your chosen tool.
Controlling Report Issue Buttons in PlugAndPlaySDK
You can easily enable or disable report issue buttons in PlugAndPlaySDK based on your application's needs.
Usage
-
Enable Report Issue Buttons:
PlugAndPlaySDK.setReportingIssuesEnabled(true);Use this when you want users to report issues.
-
Disable Report Issue Buttons:
PlugAndPlaySDK.setReportingIssuesEnabled(false);Use this to prevent users from reporting issues.