「Android BeaconSDK Getting Started」修訂間的差異

於 2016年8月15日 (一) 08:46 的修訂

簡介

TAMedia BeaconSDK提供Android App開發者簡易迅速的方式整合行動廣告，使用iBeacon進行定位資訊，提供以位置為基礎的主動廣告發送。
廣告的種類包含對話式廣告、全版Interstitial、以及通知列(Notification)等各種廣告類型，開發及整合上使用容易，僅需幾行程式碼即可輕鬆使用。

系統需求

OS : Android 5.0以上 (API 21+)

硬體需求 : 藍芽4.0

重要，請確保使用API21以上compile您的程式，targetSdkVersion可以小於21，在API21以下的裝置，SDK將不會啟動

廣告請求流程

TWMBeaconSDK將在背景服務執行，使用BluetoothLeScanner進行掃描，當偵測到Beacon時，向後端產生廣告請求，請求完成後在app端呈現，所有的廣告間隔將由後端server控制。

開始使用

請參考Android Getting Started 2.0將SDK及GooglePlayService整合進您的應用程式中

加入必要權限
TWMBeaconSDK所需使用的權限，請宣告於您的manifest檔案。

 <uses-permission android:name="android.permission.VIBRATE" /> 
 <uses-permission android:name="android.permission.INTERNET" /> 
 <uses-permission android:name="android.permission.BLUETOOTH" /> 
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
 <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /> 
 //背景喚醒裝置時使用 
 <uses-permission android:name="android.permission.WAKE_LOCK"/> 
 //Android 6.0以上使用藍芽必須加入 
 <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

加入必要Activity

TWMRedirectActivity : 廣告點擊轉導至廣告導頁之Activity

 <activity android:name="com.taiwanmobile.beaconsdk.internal.TWMRedirectActivity" 
  android:taskAffinity="com.taiwanmobile.beaconsdk.internal.TWMBeaconActivity" 
  android:excludeFromRecents="true"/>

TWMBeaconActivity : 呈現廣告主體Activity

 <activity android:name="com.taiwanmobile.beaconsdk.internal.TWMBeaconActivity" 
  android:configChanges="orientation|keyboardHidden|navigation|keyboard|screenLayout|uiMode|screenSize|smallestScreenSize" 
  android:hardwareAccelerated="true" 
  android:launchMode="singleTop"
  android:taskAffinity="com.taiwanmobile.beaconsdk.internal.TWMBeaconActivity" 
  android:excludeFromRecents="true" 
  android:theme="@android:style/Theme.Translucent"/>

加入Service

TWMBeaconService : 掃描Beacon背景服務。

 <service android:name="com.taiwanmobile.beaconsdk.service.TWMBeaconService" />

完成上述的準備動作後,就可以準備啟動廣告的程式碼 next : Banner Ads I

@@ 行 2： / 行 2： @@
 :TAMedia BeaconSDK提供Android App開發者簡易迅速的方式整合行動廣告，使用iBeacon進行定位資訊，提供以位置為基礎的主動廣告發送。<br>廣告的種類包含對話式廣告、全版Interstitial、以及通知列(Notification)等各種廣告類型，開發及整合上使用容易，僅需幾行程式碼即可輕鬆使用。
 *系統需求
-:#OS : Android 5.0以上 (API 21+)，請確保使用API21以上compile您的程式，targetSdkVersion可以小於21，在API21以下的裝置，SDK將不會啟動。 
+:OS : Android 5.0以上 (API 21+)
-:#硬體需求 : 藍芽4.0
+:硬體需求 : 藍芽4.0
+:<b><span style="color:#ff0000">重要，請確保使用API21以上compile您的程式，targetSdkVersion可以小於21，在API21以下的裝置，SDK將不會啟動</span></b>
-*以Android Studio整合SDK(包含google play service)
+*廣告請求流程
-:*整合google play service
+:TWMBeaconSDK將在背景服務執行，使用BluetoothLeScanner進行掃描，當偵測到Beacon時，向後端產生廣告請求，請求完成後在app端呈現，所有的廣告間隔將由後端server控制。
-::在module底下按下"F4"開啟"module setting"<br/>[[檔案:as_1.png]]
+*開始使用
-::並按下右側的'+'號, 新增Denpendences(Library denpendency), 在搜尋框中鍵入'play-service'可以找到對應的library<br/>[[檔案:as_2-2.png]]<br/>按下"OK"完成新增
+:*請參考[[Android Getting Started 2.0|Android Getting Started 2.0]]將SDK及GooglePlayService整合進您的應用程式中
-:*整合TAMedia SDK
-::在Android Studio檢視Project的方式檢視mobule, 並在TAMedia SDK(adpmobile-lib-rx.x.x.jar)檔案複製到新建的libs目錄底下<br/>[[檔案:as_2-3.png]]
-::打開module settings後, 新增File denpendency<br/>[[檔案:as_2-4.png]]<br/>, 並選取方才新增的TAMedia SDK後,按下"Apply"可以看到新增後的結果[[檔案:as_3.png]]
-*以eclipse 整合SDK(包含google play service)
+:*加入必要權限<br/>TWMBeaconSDK所需使用的權限，請宣告於您的manifest檔案。
-:*整合TAMedia SDK
+  <uses-permission android:name="android.permission.VIBRATE" />
-::*將TAMedia SDK JAR加入專案的buid path當中<br/>對Project點選右鍵點選'''Properties -> 點選 Java Build Path -> 點選Add External JARs''' [[檔案:Android_21.png]]
+  <uses-permission android:name="android.permission.INTERNET" />
-:*整合google play service SDK
+  <uses-permission android:name="android.permission.BLUETOOTH" />
-::*在工具列中點選'''File -> Import -> Android(Existing Android Code Into Workspace)''', 完成選擇後點選"Finish"完成google play service sdk的匯入 <br/>[[檔案:Android_27.png]][[檔案:Android_28.png]]
+  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
-:*加入必要權限<br/>TWMAd服務需使用”存取網路狀態”、”讀取約略位置”、”網路”等權限，請在AndroidManifest.xml檔案當中進行下列權限的宣告。
+  //背景喚醒裝置時使用
- <uses-permission android:name="android.permission.INTERNET"/>
+  <uses-permission android:name="android.permission.WAKE_LOCK"/>
- <uses-permission android:name="android.permission.READ_PHONE_STATE" />
+  //Android 6.0以上使用藍芽必須加入
- <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> &lt;!-- optional --&gt;
+  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
- <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> &lt;!-- optional --&gt;
+:*加入必要Activity
- <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+::TWMRedirectActivity : 廣告點擊轉導至廣告導頁之Activity <br/>
- <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
+  <activity android:name="com.taiwanmobile.beaconsdk.internal.TWMRedirectActivity"
- <uses-permission android:name="android.permission.VIBRATE" /> &lt;!-- optional --&gt;
+   android:taskAffinity="com.taiwanmobile.beaconsdk.internal.TWMBeaconActivity"
-:*加入必要Activity<br/>宣告TWMAdActivity, 並宣告對google play service的使用。
+   android:excludeFromRecents="true"/>
- &lt;!-- Google Play Service Activities --&gt;
+::TWMBeaconActivity : 呈現廣告主體Activity
- <meta-data
+  <activity android:name="com.taiwanmobile.beaconsdk.internal.TWMBeaconActivity"
-            android:name="com.google.android.gms.version"
+   android:configChanges="orientation|keyboardHidden|navigation|keyboard|screenLayout|uiMode|screenSize|smallestScreenSize"
-            android:value="@integer/google_play_services_version" />
+   android:hardwareAccelerated="true"
- <activity
+   android:launchMode="singleTop"
-  android:name="com.taiwanmobile.pt.adp.view.TWMAdActivity"
+   android:taskAffinity="com.taiwanmobile.beaconsdk.internal.TWMBeaconActivity"
-  android:configChanges="orientation|keyboardHidden|navigation|keyboard|screenLayout|uiMode|screenSize|smallestScreenSize"
+   android:excludeFromRecents="true"
-  android:hardwareAccelerated="true"
+   android:theme="@android:style/Theme.Translucent"/>
-  android:theme="@android:style/Theme.Translucent" >
+:*加入Service
- </activity>
+::TWMBeaconService : 掃描Beacon背景服務 。
+  <service android:name="com.taiwanmobile.beaconsdk.service.TWMBeaconService" />
-:完成上述的準備動作後,就可以準備啟動廣告Banner的程式碼 next : [[Android_Banner_Ads_I_2.0|Banner Ads I]]
+:完成上述的準備動作後,就可以準備啟動廣告的程式碼 next : [[Android_Banner_Ads_I_2.0|Banner Ads I]]

「Android BeaconSDK Getting Started」修訂間的差異

於 2016年8月15日 (一) 08:46 的修訂

導覽選單

搜尋