imported>Wikiuser 於 2018年10月15日 (一) 03:29

2018-10-15T03:29:45Z

←上個修訂		於 2018年10月15日 (一) 03:29 的修訂
行 7：		行 7：
	* Initial release		* Initial release
	\|-		\|-
	\|1.0.1 \|~~\| [[媒體:twmbeaconsdk_1.0.1.zip~~\|TWMBeaconSDK_1.0.1]] \|\| <center>124 KB</center> \|\|		\|1.0.1 \|\| TWMBeaconSDK_1.0.1 \|\| <center>124 KB</center> \|\|
	* SDK穩定性調整		* SDK穩定性調整
			\|-
			\|1.0.3 \|\| [[媒體:twmbeaconsdk_1.0.3.zip\|TWMBeaconSDK_1.0.3]] \|\| <center>187 KB</center> \|\|
			* Minor Fix
	\|}		\|}
	<br>		<br>

imported>Wikiuser 於 2017年7月11日 (二) 08:19

2017-07-11T08:19:19Z

←上個修訂		於 2017年7月11日 (二) 08:19 的修訂
行 53：		行 53：
	<br><br>		<br><br>

	=== ~~Document~~ ===		=== Documentation ===
	*廣告請求		*廣告請求
	:請在您程式開始的Activity加入下列程式碼，以啟動TWMBeaconSDK。啟動成功後SDK會在背景偵測附近是否有Beacon存在，並且依據Beacon的相關資訊進行廣告請求，您不需再做任何額外設定。		:請在您程式開始的Activity加入下列程式碼，以啟動TWMBeaconSDK。啟動成功後SDK會在背景偵測附近是否有Beacon存在，並且依據Beacon的相關資訊進行廣告請求，您不需再做任何額外設定。

imported>Wikiuser 於 2017年7月11日 (二) 06:58

2017-07-11T06:58:40Z

←上個修訂		於 2017年7月11日 (二) 06:58 的修訂
行 1：		行 1：
	=== Download Android Beacon SDK ===		=== Download Android Beacon SDK ===
	:~~下載位置：~~[[媒體:twmbeaconsdk_1.0.1.zip\|~~Android Beacon SDK~~]]		:{\| class="wikitable"
			\|-
			! Version !! Package !! Size !! Notes
			\|-
			\|1.0.0 \|\| TWMBeaconSDK_1.0.0 \|\| <center>1475 KB</center> \|\|
			* Initial release
			\|-
			\|1.0.1 \|\| [[媒體:twmbeaconsdk_1.0.1.zip\|TWMBeaconSDK_1.0.1]] \|\| <center>124 KB</center> \|\|
			* SDK穩定性調整
			\|}
	<br>		<br>

	=== Getting Started ===		=== Getting Started ===
	*簡介		*簡介

imported>Wikiuser 於 2017年7月11日 (二) 06:39

2017-07-11T06:39:04Z

←上個修訂		於 2017年7月11日 (二) 06:39 的修訂
行 2：		行 2：
	:下載位置：[[媒體:twmbeaconsdk_1.0.1.zip\|Android Beacon SDK]]		:下載位置：[[媒體:twmbeaconsdk_1.0.1.zip\|Android Beacon SDK]]
	<br>		<br>

	=== Getting Started ===		=== Getting Started ===
	*簡介		*簡介

imported>Wikiuser 於 2017年7月11日 (二) 06:31

2017-07-11T06:31:24Z

←上個修訂		於 2017年7月11日 (二) 06:31 的修訂
行 44：		行 44：
	<br><br>		<br><br>

	=== ~~Tutorial~~ ===		=== Document ===
	*廣告請求		*廣告請求
	:請在您程式開始的Activity加入下列程式碼，以啟動TWMBeaconSDK。啟動成功後SDK會在背景偵測附近是否有Beacon存在，並且依據Beacon的相關資訊進行廣告請求，您不需再做任何額外設定。		:請在您程式開始的Activity加入下列程式碼，以啟動TWMBeaconSDK。啟動成功後SDK會在背景偵測附近是否有Beacon存在，並且依據Beacon的相關資訊進行廣告請求，您不需再做任何額外設定。

imported>Wikiuser：新頁面: === Download Android Beacon SDK === :下載位置：Android Beacon SDK
=== Getting Started === *簡介 :TAMedia BeaconSDK提供Android App開發...

2017-07-11T06:30:31Z

新頁面: === Download Android Beacon SDK === :下載位置：Android Beacon SDK === Getting Started === *簡介 :TAMedia BeaconSDK提供Android App開發...

新頁面

=== Download Android Beacon SDK ===
:下載位置：[[媒體:twmbeaconsdk_1.0.1.zip|Android Beacon SDK]]
 

=== Getting Started ===
*簡介
: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|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" />
 

=== Tutorial ===
*廣告請求
:請在您程式開始的Activity加入下列程式碼，以啟動TWMBeaconSDK。啟動成功後SDK會在背景偵測附近是否有Beacon存在，並且依據Beacon的相關資訊進行廣告請求，您不需再做任何額外設定。
//依序傳入activity , 版位ID , TWMBeaconRequest
TWMBeaconSDK.init(MainActivity.this, 您的版位ID, new TWMBeaconRequest.Builder.build());
*TWMBeaconRequest
::TWMBeaconRequest為請求設定檔，提供的function及說明如下，請依您的需求進行設定。 
:*設定通知列small icon
::強烈建議將通知icon設為您希望顯示的icon，若未設定則會以app icon作為替代。
[[檔案:beaconsdk_tutorial_2.png]]
setNotificationIcon(int icon)
:*設定掃描模式
::TWMBeaconSDK提供與原生方法相同的三種掃描模式，預設為LowPower模式。若無特殊需求，建議您不需設定此選項。 SCAN_MODE_BALANCED , SCAN_MODE_LOW_LATENCY ,SCAN_MODE_LOW_POWER
setScanMode(ScanMode scanMode)
:*設定測試模式
::測試模式所有的請求將不會被記錄，傳入的testDevice字串請您參考[[Android_Banner_Ads_I_2.0|Android_Banner_Ads_I_2.0]]
addTestDevice(String testDevice)
setTestDevices(Set<String> testDevices)
*加入TWMBeaconListener監聽廣告投放情況
TWMBeaconSDK.setAdListener(new TWMBeaconListener() {
@Override
public void onReceiveAd() {
// 成功收到廣告時通知
}
@Override
public void onFailedToReceiveAd(TWMBeaconRequest.ErrorCode errorCode) {
// 當請求廣告失敗時通知
}
@Override
public void onPresentScreen() {
// 廣告呈現在頁面時通知
}
@Override
public void onDismissScreen() {
// 關閉廣告時通知
}
@Override
public void onFailedStart (String errorMessage) {
// 無法成功開啟服務時通知
}
});
*完整範例請參考下列
:*Activity
package com.taiwanmobile.beacontest;
import android.content.Intent;
import android.os.Bundle;
import android.support.annotation.NonNull;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import com.taiwanmobile.beaconsdk.settings.BluetoothDialogSettings;
import com.taiwanmobile.beaconsdk.internal.TWMBeaconRequest;
import com.taiwanmobile.beaconsdk.internal.TWMBeaconListener;
import com.taiwanmobile.beaconsdk.internal.TWMBeaconSDK;
import com.taiwanmobile.beaconsdk.service.TWMBeaconService;
public class MainActivity extends AppCompatActivity {
TWMBeaconRequest request;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//設定TWMBeaconRequest
request = new TWMBeaconRequest.Builder()
//設定通知列icon
.setNotificationIcon(YOUR_ICON)
.build();
//啟動TWMBeaconSDK
TWMBeaconSDK.init(MainActivity.this, "您的版位ID", request);
TWMBeaconSDK.setAdListener(new TWMBeaconListener() {
@Override
public void onReceiveAd() {
}
@Override
public void onFailedToReceiveAd(TWMBeaconRequest.ErrorCode errorCode) {
}
@Override
public void onFailedStart(String errorMessage) {
}
@Override
public void onPresentScreen() {
}
@Override
public void onDismissScreen() {
}
});
}
}

:*Manifest
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.taiwanmobile.beacontest">
<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"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<application
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme">
<activity
android:name=".MainActivity"
android:label="@string/app_name"
android:theme="@style/AppTheme.NoActionBar">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<activity android:name="com.taiwanmobile.beaconsdk.internal.TWMRedirectActivity"
android:taskAffinity="com.taiwanmobile.beaconsdk.internal.TWMBeaconActivity"
android:excludeFromRecents="true"/>
<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 android:name="com.taiwanmobile.beaconsdk.service.TWMBeaconService" />
</application>
</manifest>

*畫面展示
{| width="50%" border="1"
|-
| align="center" | 插頁全版廣告
| align="center" | 插頁彈跳文字廣告
| align="center" | 插頁彈跳圖文廣告
|-
| align="center" | [[檔案:Beacon_sdk_demo1.png]]
| align="center" | [[檔案:Beacon_sdk_demo2.png]]
| align="center" | [[檔案:Beacon_sdk_demo3.png]]
|}
 

=== Proguard Configuration ===
:如果您的APP本身需要經過proguard混淆，請增加下面的設定 
<nowiki>#</nowiki>Tamedia BeaconSDK
-keep class com.taiwanmobile.beaconsdk.** { *; }
-dontwarn com.taiwanmobile.beaconsdk.**

Android Beacon Ad SDK Tutorial - 修訂歷史