檢視 SDK8 Interstitial 的原始碼

<!-- [[IOS SDK Developer Guide v2|回 iOS首頁]]<br> -->
[[SDK8 iOS SDK Developer Guide|回 SDK 8首頁]]<br>

== 簡介==
Interstitial 廣告可以在 app 啟動, 視頻載入期間或遊戲暫停的時候，呈現內容豐富的蓋版 HTML5 網頁。<br>
以下將告訴您如何讓您的 app 顯示Interstitial廣告。<br>

== 串接準備 ==
開始串接前請間確定已將 TAmedia SDK 整合至專案，並且完成[http://wiki.tamedia.com.tw/wiki/SDK8_Getting_Started_Guide#.E5.88.9D.E5.A7.8B.E5.8C.96.E8.A1.8C.E5.8B.95.E5.BB.A3.E5.91.8A_SDK 初始化 SDK]步驟，若您尚未完成請先參考[[SDK8 Getting Started Guide |開始使用教學]]完成相關設定。

== 加入 TADInterstitial ==
TADInterstitial 的用法與 TADBannerView 相似，簡單的步驟即可加入TADInterstitial
建議在 UIViewController 中執行以下步驟:

:*匯入 import TAMediaAdsFramework
:*在 UIViewController 中宣告 TADInterstitial 執行個體
:*建立插頁式廣告
:*設定廣告單元編號
:*建立Request請求廣告

== InterstitialViewController.swift ==
<source>
import TAMediaAdsFramework

class InterstitialViewController: UIViewController {

    var interstitialView: TADInterstitial?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        requestAd()
    }

    func requestAd() {
        self.resultLabel.text = "Loading..."

        let request = TADRequest()
        request.setLocationWithLatitude(25.02246916213678, longitude: 121.54834205241194, accuracy: 1)
        request.showLog = true
        interstitialView = TADInterstitial()
        interstitialView?.delegate = self

        //是否使用麥克風廣告 default為Yes,依需求修改 [註1]
        interstitialView?.turnOnMicrophone = false

        //讓廣告控制audioSessionControl default為Yes,依需求修改 [註2]
        interstitialView?.allowAudioSessionControl = true

        interstitialView?.adUnitID = [_YOUR_AD_UNIT_AD_]

        interstitialView?.load(request)
    }
}
</source>


== TADInterstitialDelegate ==
<source>
extension InterstitialViewController: TADInterstitialDelegate {
    // 廣告取得成功，可以在此時間點及之後顯示呈現廣告
    func interstitialDidReceiveAd(_ ad: TADInterstitial!) {
        ad.present(fromRootViewController: self)
    }

    // 廣告取得失敗
    func interstitial(_ ad: TADInterstitial!, didFailToReceiveAdWithError error: TADRequestError!) {
    }

    // Interstitial廣告呈現之前呼叫, 注意使用者可能會在廣告內按下連結(網頁, AppStore, ...)而因此離開應用程式, 可以在這function中處理該暫停之項目
    func interstitialWillPresentScreen(_ ad: TADInterstitial!) {
    }

    // Interstitial廣告關閉, 在螢幕上消失之前呼叫, 再次提醒在Interstitail消失前, 必須將Interstitial及delegate設為nil (可以在這個function中執行)
    func interstitialWillDismissScreen(_ ad: TADInterstitial!) {
        self.interstitialView?.delegate = nil;
        self.interstitialView = nil;
    }

    // Interstitial廣告關閉, 在螢幕上消失之後呼叫
    func interstitialDidDismissScreen(_ ad: TADInterstitial!) {
    }

    // 使用者在廣告內按下連結(網頁, AppStore, ...)而因此離開應用程式之前呼叫
    func interstitialWillLeaveApplication(_ ad: TADInterstitial!) {
    }
}
</source>


[註1]TADBannerView 及 TADInterstitial增加此屬性，Default為YES。設為YES會去使用TADMicrophoneDetector物件，進而拿到麥克風類型廣告，與使用者互動，設為NO，則回傳server無Microphone。因為使用麥克風廣告會造成音樂類型的app中斷播放，建議音樂類型app在此設為NO。

[註2]allowAudioSessionControl設為YES以及原本app的AudioSession category為AVAudioSessionCategorySoloAmbient或AVAudioSessionCategoryPlayback時，將由SDK控制AudioSession設定active及改變category以滿足背景音樂中斷及續撥的行為。若是設為NO或category原本設定並非上述兩種SDK將不會去對AudioSession做改變，而是交給開發者在插頁出現及消失時，依據想要的行為做設定。


<!-- [[IOS SDK 2.0 Developer Guide|回 iOS首頁]] -->
[[SDK8 iOS SDK Developer Guide|回 SDK 8首頁]]