potatotips #27 発表資料。

1. ネットワークの切り替えを
感知する方法
potatotips #27 (Android)
ヤマグチケイスケ

2. 自己紹介
• 名前：ヤマグチケイスケ
• Github： ykeisuke
• Qiita: YKEI_mrn
• MAIL: yamagutikeisuke@gmail.com
• 職業：フリーランス
– 出向中：（株）アスクリード
– 出来る事
• サーバー立てる。
• サーバー側でWebAPI書く。
• WebAPIを使ったAndroidアプリ書く
• LPつくる
• CakePHP/Android/iOS
• Illustratorもできる。

3. 条件
• Android5.0以上

4. 目的
• Androidが使っているネットワークの切り替え
を感知することが目的。
• 例えば、WiFi通信からCellular通信に変わった
時とか。

5. 実装（概要)
• Android5.0(APIレベル21)から実装されている、
NetworkRequest.Builderクラスを利用する。
– reference：
https://developer.android.com/intl/ja/reference/a
ndroid/net/NetworkRequest.Builder.html

6. 実装（詳細）：1
this.cm = (ConnectivityManager)
getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkRequest.Builder reqBuilder = new NetworkRequest.Builder();
• ConnectivityManagerを作成し、
NetworkRequest.Builderを用意する。

7. 実装（詳細）：２
this.cm.registerNetworkCallback(reqBuilder.build(),
new ConnectivityManager.NetworkCallback() {
private String TAG = “CM”;
@Override
public void onCapabilitiesChanged(Network network,
NetworkCapabilities networkCapabilities) {
Log.d(TAG, “onCapabilities networkCapabilities : ”
+ networkCapabilities.toString()
+ “, network : ” + network.toString());
}
// （略）
• イベント通知を受け取る

8. 簡単

9. TIPS1
『関係のあるイベントのみ感知したい。』
例えば、WANに繋がるCellular通信の場合のみとか
NetworkRequest.Builder reqBuilder = new NetworkRequest.Builder();
reqBuilder.addCapability(NetworkCapabilities.NET_CAPABILITY_NOT_RESTRICTED);
reqBuilder.addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR);
• 「new NetworkRequest.Builder」に、「addCapability」と、
「addTransportType」で追加すればよい。

10. TIPS2
『「addCapability」と「addTransportType」で何が
追加できるのか？』
• 「NetworkCapabilities」で追加できるものは全
部追加できる。
– https://developer.android.com/intl/ja/reference/andr
oid/net/NetworkCapabilities.html
• 例えば、「Cellular通信のみ」や「WiFi通信のみ」
「VPNではない時」など

11. TIPS3(1)
『どのようなイベントで処理を発火できるか』
• 「ConnectivityManager.NetworkCallback」クラ
ス(API21〜)で定義されている メソッドを使え
る
• この点がAPI21から新たに増えてる(?)
– 調べ切れていない。

12. TIPS3(2)
• onAvailable
– 準備が出来たとき
• onCapabilitiesChanged
– 接続完了し、ネットワークが変わったあと
• onLinkPropertiesChanged
– LinkPropertiesが変わったあと
• onLosing
– 接続を失ったとき(失ってる時！）
• onLost
– 接続を失ったとき（完全に、接続が切れたとき！）
• （onLosingとonLostの違いは瞬断対策のようです）