complication

complicationについて成田元輝

• この資料は一般に公開されている情報(WWDCのセッション、デベロッパーアカウントがなくてもアクセス可能なもの)を元に作成されています

Attention

complication

• 時計のフェイスに情報を表示できる

• 時系列ごとの情報の表示が可能Time Travel

• 表示領域をタップするとWatch Appへ遷移する

complication

参考資料

watchOS 2 Transition Guide

https://developer.apple.com/library/prerelease/watchos/documentation/General/Conceptual/AppleWatch2TransitionGuide/DesigningaComplication.html#//apple_ref/doc/uid/TP40015234-CH11-SW1


Creating Complications with ClockKit

https://developer.apple.com/videos/wwdc/2015/?id=209

https://developer.apple.com/videos/wwdc/2015/?id=209

Complication Families

complication

• Complication Familiesごとにレイアウトが複数用意されている

• 全てのComplication Familiesをサポートする必要はない



Modular small

Modular

Creating complication with ClockKitより



Modular small

Modular large

Modular



Modular small

Modular large

Utilitarian small

Utilitarian



Modular small

Modular large

Utilitarian small

Utilitarian large

Utilitarian



Modular small

Modular large

Utilitarian small

Utilitarian large

Circular small

Circular

CLKComplicationTemplate

Utilitarian SmallModular Large

Utilitarian Large

11:00AM

Group DHaight – Twin Peaks

Modular Small Circular Small




class CLKComplicationTemplateModularLargeStandardBody {

var headerImageProvider: CLKImageProvider?

var headerTextProvider: CLKTextProvider

var body1TextProvider: CLKTextProvider

var body2TextProvider: CLKTextProvider?

}


11:00AM

Group DHaight – Twin Peaks

Body 2 textBody 1 text

Header image Header text



• 文字列はCLKTextProviderとCLKTextProviderを継承したクラス

• 表示形式に適したCLKComplicationTemplateを選んで使用する

CLKComplicationDataSource

• complicationの表示のために必要なデータを作成

• データを適したテンプレートにパッケージングすること


// complicationでTimeTravelでサポートする方向- getSupportedTimeTravelDirectionsForComplication:withHandler:


struct CLKComplicationTimeTravelDirections : OptionSetType { init(rawValue rawValue: UInt) static var None: CLKComplicationTimeTravelDirections { get } static var Forward: CLKComplicationTimeTravelDirections { get } static var Backward: CLKComplicationTimeTravelDirections { get }}

CLKComplicationTimeTravelDirections

TimeTravelでサポートする方向を決める

// 開始時間- getTimelineStartDateForComplication:withHandler:

// 終了時間- getTimelineEndDateForComplication:withHandler:

CLKComplicationDataSourcecomplicationに表示する情報のサポート時間範囲

• 範囲外の時間になったらcomplicationが暗転する

- getPrivacyBehaviorForComplication:withHandler:

CLKComplicationDataSourcecomplicationに表示するデータのプライバシー設定

CLKComplicationPrivacyBehaviorShowOnLockScreenCLKComplicationPrivacyBehaviorHideOnLockScreen

ロック時に表示させたくない場合はCLKComplicationPrivacyBehaviorHideOnLockScreenを返す

// 現在の時間のデータを返す- getCurrentTimelineEntryForComplication:withHandler:

// TimeTravelで過去の時間のデータを表示させる際に使用- getTimelineEntriesForComplication:beforeDate:limit:withHandler:

// TimeTravelで未来の時間のデータを表示させる際に使用- getTimelineEntriesForComplication:afterDate:limit:withHandler:

CLKComplicationDataSourcecomplicationに表示するデータの設定

- getPlaceholderTemplateForComplication:withHandler:

CLKComplicationDataSourcecomplication設定時に表示するデータを設定

• データソースのメソッドは最小限にとどめておくこと

The implementations of your data source methods should be minimal.

• 通信してデータを取ってくるとか計算とかデータの転送が遅れるようなことはしない

Do not use your data source methods to fetch data from the network, compute values, or do anything that might delay the delivery of that data.

• データの取得や計算が必要な場合はiOSアプリ側で行ったり、WatchKit extensionの別の場所で行い、それをcomplicationからアクセス可能な場所にキャッシュさせて使用すること

If you need to fetch or compute the data for your complication, do it in your iOS app or in other parts of your WatchKit extension and cache the data in a place where your complication data source can access it.

• データソースのメソッドではキャッシュしたデータを取ってきて、ClockKitの要求するフォーマットに設定するだけにするThe only thing your data source methods should do is take the cached data and put it into the format that ClockKit requires

注意点

おわり

complication

Mobile