Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Info

Import com.visilabs.android.* package to all files for which you will be using the SDK.

There are 4 different usages of the SDK:

1- Sending data to RMC

2- Sending data to RMC and Receiving Recommendations

...

Info

Please use only one of the methods based on your needs and requirements.

...

Sending data to RMC

Use the following method to only send data to RMC: 

Code Block
languagejava
Visilabs.CreateAPI("OrganizationID","SiteID", "http://lgr.visilabs.net", "DataSource", "http://rt.visilabs.net" , "Android" , getApplicationContext());

...

Sending Data to RMC and Receiving Recommendations

Use the following method to send data to RMC and to receive Recommendations:

Code Block
languagejava
Visilabs.CreateAPI("OrganizationID", "SiteID", "http://lgr.visilabs.net", "DataSource", "http://rt.visilabs.net" , "Android" , getApplicationContext(), requestTimeout, "http://s.visilabs.net/json");

...

Sending Data to RMC, Receiving Recommendations and In-App Messages 

Use the following method to send data to RMC, to receive Recommendations and In-App messages:

Code Block
languagejava
Visilabs.CreateAPI("OrganizationID", "SiteID", "http://lgr.visilabs.net", "DataSource", "http://rt.visilabs.net" , "Android" , getApplicationContext(), "http://s.visilabs.net/json", "http://s.visilabs.net/actjson", requestTimeout);

...

Sending Data to RMC, Receiving Recommendations and In-App Messages and Running Geofence Module

Use the following method to send data to RMC, to receive Recommendations and In-App messages and to run Geofence Module. If you are using this overload of CreateAPI method, define parameters in AndroidManifest.xml file.

Code Block
languagejava
Visilabs.CreateAPI(getApplicationContext());
Code Block
languagejava
<meta-data android:name="VisilabsOrganizationID" android:value="VisilabsOrganizationID" />
<meta-data android:name="VisilabsSiteID" android:value="VisilabsSiteID" />
<meta-data android:name="VisilabsSegmentURL" android:value="http://lgr.visilabs.net" />
<meta-data android:name="VisilabsDataSource" android:value="VisilabsDataSource" />
<meta-data android:name="VisilabsRealTimeURL" android:value="http://rt.visilabs.net" />
<meta-data android:name="VisilabsChannel" android:value="Android" />
<meta-data android:name="VisilabsGeofenceURL" android:value="http://s.visilabs.net/geojson" />
<meta-data android:name="VisilabsGeofenceEnabled" android:value="true" />

<!-- Parameters below are optional --!>

<meta-data android:name="VisilabsRequestTimeoutInSeconds" android:value="30" />
<meta-data android:name="VisilabsRESTURL" android:value="VisilabsRESTURL" />
<meta-data android:name="VisilabsEncryptedDataSource" android:value="VisilabsEncryptedDataSource" />
<meta-data android:name="VisilabsTargetURL" android:value="http://s.visilabs.net/json" />
<meta-data android:name="VisilabsActionURL" android:value="http://s.visilabs.net/actjson" />

...

Code Block
languagexml
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission <service android:name="com.visilabs.android.gps.geofence.GeofenceTransitionsIntentServicepermission.ACCESS_BACKGROUND_LOCATION" />

<service
 android:enabled="true"     android:permission="android.permission.BIND_JOB_SERVICE" />  <service     android:name="com.visilabs.android.gps.geofence.GeofenceMonitorGeofenceTransitionsIntentService"
            android:enabled="true"
        android:exported="true"/>   <receiver android:namepermission="com.visilabs.android.gps.geofence.GeofenceTransitionsReceiver"permission.BIND_JOB_SERVICE" />

   android:enabled="true" android:exported="true">
       <receiver
  <intent-filter>         <action android:name="com.visilabs.android.gps.geofence.ACTION_RECEIVE_GEOFENCE" />VisilabsAlarm"
       </intent-filter> </receiver>  <receiver android:name="com.visilabs.android.gps.geofence.VisilabsAlarm" android:exported="false" />

        <receiver
            android:name="com.visilabs.android.gps.geofence.GeofenceBroadcastReceiver"
            android:enabled="true"
            android:exported="true" />
Info

To learn the OrganizationIDSiteID and Datasource Parameters, login to RMC GUI and view your profile details or send a request to RMC support.