Android BeaconSDK Getting Started

• 簡介

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

• 系統需求

1. OS : Android 5.0以上 (API 21+)，請確保使用API21以上compile您的程式，targetSdkVersion可以小於21，在API21以下的裝置，SDK將不會啟動。 
2. 硬體需求 : 藍芽4.0

• 以Android Studio整合SDK(包含google play service)

• 整合google play service

在module底下按下"F4"開啟"module setting"

並按下右側的'+'號, 新增Denpendences(Library denpendency), 在搜尋框中鍵入'play-service'可以找到對應的library

按下"OK"完成新增

• 整合TAMedia SDK

在Android Studio檢視Project的方式檢視mobule, 並在TAMedia SDK(adpmobile-lib-rx.x.x.jar)檔案複製到新建的libs目錄底下

打開module settings後, 新增File denpendency

, 並選取方才新增的TAMedia SDK後,按下"Apply"可以看到新增後的結果

• 以eclipse 整合SDK(包含google play service)

• 整合TAMedia SDK

• 將TAMedia SDK JAR加入專案的buid path當中
  對Project點選右鍵點選Properties -> 點選 Java Build Path -> 點選Add External JARs

• 整合google play service SDK

• 在工具列中點選File -> Import -> Android(Existing Android Code Into Workspace), 完成選擇後點選"Finish"完成google play service sdk的匯入
  

• 加入必要權限
  TWMAd服務需使用”存取網路狀態”、”讀取約略位置”、”網路”等權限，請在AndroidManifest.xml檔案當中進行下列權限的宣告。

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> <!-- optional -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- optional -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 
<uses-permission android:name="android.permission.VIBRATE" /> <!-- optional -->

• 加入必要Activity
  宣告TWMAdActivity, 並宣告對google play service的使用。

<!-- Google Play Service Activities -->
<meta-data
           android:name="com.google.android.gms.version"
           android:value="@integer/google_play_services_version" />
<activity
 android:name="com.taiwanmobile.pt.adp.view.TWMAdActivity"           
 android:configChanges="orientation|keyboardHidden|navigation|keyboard|screenLayout|uiMode|screenSize|smallestScreenSize"
 android:hardwareAccelerated="true"
 android:theme="@android:style/Theme.Translucent" >
</activity>

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