Android BeaconSDK Getting Started

出自TAMedia
於 2016年8月15日 (一) 08:46 由 imported>Wikiuser 所做的修訂
跳至導覽 跳至搜尋
  • 簡介
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控制。
  • 開始使用
  • 加入必要權限
    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