InStream Android Developer Guide - 修訂歷史

imported>Wikiuser 於 2018年10月29日 (一) 09:40

2018-10-29T09:40:08Z

←上個修訂		於 2018年10月29日 (一) 09:40 的修訂
行 93：		行 93：
	<br>		<br>

	:Google IMA ~~會根據您的網路選擇合適的影片廣告素材，若您需要限制廣告影片的bitrate，可在AdsManager呼叫init前執行下列程式：~~		:Google IMA SDK 會根據您的網路選擇合適的廣告影片，若您需要限制廣告影片的bitrate，可在AdsManager呼叫init前執行下列程式：
	AdsRenderingSettings renderingSettings = mSdkFactory.createAdsRenderingSettings();		AdsRenderingSettings renderingSettings = mSdkFactory.createAdsRenderingSettings();
	renderingSettings.setBitrateKbps(2000); // 單位為kbit/s		renderingSettings.setBitrateKbps(2000); // 單位為kbit/s

imported>Wikiuser 於 2018年10月29日 (一) 09:38

2018-10-29T09:38:54Z

←上個修訂		於 2018年10月29日 (一) 09:38 的修訂
行 12：		行 12：
	! Version !! Package !! Size !! Notes		! Version !! Package !! Size !! Notes
	\|-		\|-
	\|1.0.0 \|\|[[媒體:TAMInStreamAndroidUtil_1.0.0.zip\|TAMInStreamAndroidUtil_1.0.0]] \|\| ?? KB \|\|		\|1.0.0 \|\|[[媒體:TAMInStreamAndroidUtil_1.0.0.zip\|TAMInStreamAndroidUtil_1.0.0]] \|\| 207 KB \|\|
	* Initial Release		* Initial Release
	\|}		\|}
行 91：		行 91：
	:若需要使用測試模式，請在adTagBuilder.build前加入下列程式碼		:若需要使用測試模式，請在adTagBuilder.build前加入下列程式碼
	adTagBuilder.setTestMode(true);		adTagBuilder.setTestMode(true);
			<br>

			:Google IMA 會根據您的網路選擇合適的影片廣告素材，若您需要限制廣告影片的bitrate，可在AdsManager呼叫init前執行下列程式：
			AdsRenderingSettings renderingSettings = mSdkFactory.createAdsRenderingSettings();
			renderingSettings.setBitrateKbps(2000); // 單位為kbit/s
			mAdsManager.init(renderingSettings);
	<br><br>		<br><br>

imported>Wikiuser 於 2018年10月16日 (二) 03:58

2018-10-16T03:58:30Z

←上個修訂		於 2018年10月16日 (二) 03:58 的修訂
行 6：		行 6：
	<br><br>		<br><br>

	== <b>下載 ~~Utility~~</b> ==		== <b>下載 Util</b> ==
	:~~請至下列連結下載Utility和範例專案~~		:請至下列連結下載Util和範例專案
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
行 21：		行 21：

	<big><u>Step 1: 將JAR檔放入app專案的<b>libs</b>資料夾</u></big><br>		<big><u>Step 1: 將JAR檔放入app專案的<b>libs</b>資料夾</u></big><br>
	:請至[[#下載 ~~Utility~~\|下載 ~~Utility~~]]取得InStream ~~Utility，並將壓縮檔內的JAR檔~~ (tam-instream-rx.x.x.jar) 放至專案的libs資料夾, 若無libs資料夾請自行建立		:請至[[#下載 Util\|下載 Util]]取得InStream Util，並將壓縮檔內的JAR檔 (tam-instream-rx.x.x.jar) 放至專案的libs資料夾, 若無libs資料夾請自行建立
	<br><br><br>		<br><br><br>

imported>Wikiuser：新頁面: TAMedia InStream Android 版開發指南 == 簡介 == :TAMedia InStream可搭配Google IMA SDK獲得VAST影音廣告，該廣告可在Player撥放影片前、中、後呈現，...

2018-10-16T03:54:09Z

新頁面: TAMedia InStream Android 版開發指南 == 簡介 == :TAMedia InStream可搭配Google IMA SDK獲得VAST影音廣告，該廣告可在Player撥放影片前、中、後呈現，...

新頁面

TAMedia InStream Android 版開發指南

== 簡介 ==
:TAMedia InStream可搭配Google IMA SDK獲得VAST影音廣告，該廣告可在Player撥放影片前、中、後呈現，下列章節將說明TAMedia InStream的串接方式。
:系統需求: Android 4.1+ (API 16+)
 

== 下載 Utility ==
:請至下列連結下載Utility和範例專案
{| class="wikitable"
|-
! Version !! Package !! Size !! Notes
|-
|1.0.0 ||[[媒體:TAMInStreamAndroidUtil_1.0.0.zip|TAMInStreamAndroidUtil_1.0.0]] || ?? KB ||
* Initial Release
|}
 

== 開始使用 ==
:請依照下列方式設置專案 

<big>Step 1: 將JAR檔放入app專案的libs資料夾</big> 
:請至[[#下載 Utility|下載 Utility]]取得InStream Utility，並將壓縮檔內的JAR檔 (tam-instream-rx.x.x.jar) 放至專案的libs資料夾, 若無libs資料夾請自行建立
 

<big>Step 2: 在app-level的build.gradle設置dependencies</big> 
:打開app-level的build.gradle檔 
:[[image:Instream-android-step2.PNG | 300px]] 
:在dependencies內加入Google IMA, Google Play Services和TAMedia Instream等Library 
dependencies {
implementation 'com.google.ads.interactivemedia.v3:interactivemedia:3.9.4'
implementation 'com.google.android.gms:play-services-ads:15.0.1'
implementation files('libs/tam-instream-rx.x.xi.jar')

// other dependencies ..
}
 

<big>Step 3: 在project-level的build.gradle的repositories內加入google()</big> 
:打開project-level的build.gradle檔 
:[[image:Instream-android-step3.PNG | 300px]] 
:Google Play Service版本若為11.2+, 必須在repositories新增google(), 這是因為Google Play Service自11.2版本後, 改透過maven.google.com取得
buildscript {
repositories {
google()
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.0.1'
}
}

allprojects {
repositories {
google()
jcenter()
}
}
 

<big>Step 4: 加入必要權限</big> 
:打開AndroidManifest.xml 
:[[image:Instream-android-step4.PNG | 300px]] 

:在 AndroidManifest.xml 內加入下列Permission
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
 
:在 AndroidManifest.xml 的application tag內加入Google Play Service的meta tag
<meta-data
android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />
 

== 使用方式 ==
:使用上與Google IMA並無太大差異，大部分的步驟仍然可參考[https://developers.google.com/interactive-media-ads/docs/sdks/android/ Google IMA Get Started]的教學 

:但在呼叫setAdTagUrl、requestAd的部分，需要改寫成下列程式碼
TWMAdTagBuilder adTagBuilder = new TWMAdTagBuilder(getContext(),"<Your TAMedia Ad Tag Url>");
adTagBuilder.build(new TWMAdTagListener() {
@Override
public void onReceiveTag(String adTagUrl) {
mAdRequest.setAdTagUrl(adTagUrl);
mAdsLoader.requestAds(mAdRequest);
}
});
 

:若需要使用測試模式，請在adTagBuilder.build前加入下列程式碼
adTagBuilder.setTestMode(true);
 

== 設置ProGuard ==
:若您的專案需要ProGuard，請在ProGuard檔加入下列設置
##------------ Start: proguard configuration for InStream ----------
-keep public class com.taiwanmobile.pt.ima.** {*;}
##------------ End: proguard configuration for InStream ----------

##------------ Start: proguard configuration for Google Play Service & IMA ----------
-dontwarn com.google.ads.**
-keep class com.google.** { *; }
-keep interface com.google.** { *; }
-keep class com.google.ads.interactivemedia.** { *; }
-keep interface com.google.ads.interactivemedia.** { *; }
##------------ End: proguard configuration for Google Play Service & IMA ----------

 
[[InStream_Developer_Guide | 回首頁]]