Cocoaの日々

いろいろやったということで。









決定はこれ

StackOneで使える予約語の一覧を公開。日本・日本語以外にも対応しているので、値によっては他の予約語と同じ値を返すものや、値が無いもの（空）がある。

日時

意味	タグ	例
日付	%date	2014/8/30
日付 (ショートスタイル)	%date1	2014/8/30
日付 (ミディアムスタイル)	%date2	2014/8/30
日付 (ロングスタイル)	%date3	2014年8月30日
日付 (フルスタイル)	%date4	2014年8月30日土曜日
時刻	%time	20:04
時刻 (ショートスタイル)	%time1	20:04
時刻 (ミディアムスタイル)	%time2	20:04:09
時刻 (ロングスタイル)	%time3	20:04:09 JST
時刻 (フルスタイル)	%time4	20時04分09秒 日本標準時
年	%y	2014
年	%yy	14
月	%yyyy	2014
月	%M	8
月	%MM	08
月	%MMM	8月
月	%MMMM	8月
日	%d	30
日	%dd	30
曜日	%eee	土
曜日	%eeee	土曜日
時	%h	8
時	%hh	08
時	%k	20
時	%kk	20
時	%H	20
時	%HH	20
分	%m	4
分	%mm	04
秒	%s	9
秒	%ss	09
午前/午後	%a	午後
タイムゾーン	%zzz	JST
タイムゾーン	%zzzz	日本標準時
タイムゾーン	%ZZZ	900
タイムゾーン	%ZZZZ	GMT+09:00

位置情報

意味	タグ	例
住所	%address	東京都 中央区日本橋9丁目101番3号
緯度	%latitude	35.681382.
経度	%longitude	139.766084.
地図リンク	%map	<a href="http://maps.google.com/maps?q=地図@35.681382,139.766084&z=16">地図</a>

住所

意味	タグ	例
市区町村	%addr.Citry	東京都中央区
国	%addr.Country	日本
国コード	%addr.CountryCode	JP
場所名	%addr.Name	日本橋9丁目101番3号
郵便番号拡張	%addr.PostCodeExtension
都道府県	%addr.State	東京都
番地	%addr.Street	日本橋9丁目101番3号
行政区	%addr.SubAdministrativeArea
町	%addr.SubLocality	日本橋
番地	%addr.SubThoroughfare	101番3号
町丁	%addr.Thoroughfare	日本橋9丁目
国	%addr.ZIP	〒103-0123

- - - -

StackOne活用方法の紹介記事。旅行の写真に一言添えてエバーノートに記録。いいね。

「カゴの中身はいくら？」

「予算1000円だけどあといくら買える？」（もちろん消費税も考慮して）
「これをやめたら、あれを買えるかな？」

買物専用の電卓を作りました。
ただ、ただ、金額を入れるだけで計算完了です。
何も難しい操作は要りません。ただ入れるだけでいいのです。

特徴
・簡単入力でさくさく計算
・予算設定で、あといくら買えるか一目瞭然
・タイムセールの％割引に対応
・強力な消費税対応（内税・外税、精算方式に切り捨て方法まで）
・便利な買物リスト
・買物スキルを磨く、買物スコアに買物レベル（ゲーム感覚）

特に便利なのが「あといくら」。例えば予算 1,000円と設定しておけば、予算内で買える金額がひと目でわかります。もちろん消費税が考慮されているのでレジに行ったら消費税分が予算オーバー、なんてことはありません。予算設定は意外にハマる機能で、あーでもないこーでもないと試行錯誤が繰り返していくと買い物がゲームみたいな感覚に。何よりも予算ぴったりに買い物ができた時は結構うれしかったりします。

毎日の買い物がきっと楽しくなる「買い物さん」を是非お試し下さい。
（奥さまがいる方は是非おすすめ下さいませ）

エバーノート投稿アプリ【StackOne】の最新バージョン 1.4 がリリースされました。


今回のリリースから iPadでも使えるようになりました。








投稿後のノートはこんな感じで見えます(エバーノートiPad版）。


紹介記事など




- - - -
iPad対応記念セール実施中です。
４００円→１００円

興味のある方はこの機会にどうぞ。

極私的メモ。UINavigationControllerで遷移してきた画面でUITableViewを表示する時、任意の位置のセルで初期表示したい。

- (void)viewWillAppear:(BOOL)animated
{
    [super viewWillAppear:animated];
    [self.tableView reloadData];
    [self _scrollAnimated:NO];          // 任意のセルへスクロール
}

viewWillAppearに書いてもだめ(iOS7)。viewDidAppearだと画面がちらつく。

viewDidLayoutSubviewsに書いたらうまくいった。ただしフラグを使って初回だけに限定してやる。

@property (nonatomic, assign) BOOL didLayoutSubviews;

- (void)viewDidLayoutSubviews
{
    [super viewDidLayoutSubviews];
    if (!self.didLayoutSubviews) {
        [self _scrollAnimated:NO];
        self.didLayoutSubviews = YES;
    }
}

エバーノート投稿アプリ【StackOne】の最新バージョン 1.3 がリリースされました。



主な新機能
・TextExpander
・ルール並び替え
・ルールリスト
ほか


今回はプロモーション動画を作ってみた。

素人感丸出し。。当初は手に持って実際に操作しているところを撮影しようかと思い、他のiPhoneで撮影するなどやってみたがこれは手間がかかりすぎるため断念。今回はスクリーンだけを写す簡易な方法を撮った。最近はスクリーンだけのプロモ動画は少なく、数年前の古さを感じさせる雰囲気あり。


使ったアプリは２つだけ。

[1]Reflector - iPhoneの画面をAirPlay経由でMacに移すアプリ。$12.99で購入。
これは結構役にたった。なおYosemite+iOS8では標準で同等のことができるようになるらしいが。

[2]iMovie - 動画の編集

iMovieは初めての操作だったけど、今回の動画は３〜４時間ぐらいでできたと思う。操作する時はあまり細かい事は考えずにとにかく必要な場面（シーン）をたくさん撮るのがコツで、最後にiMovieで切り貼り編集して見られる動画にまとめていくという流れ。一度場面が揃えばあとは編集で（ある程度）どうにでもなるので一旦慣れてしまえば意外に面倒さはなかった。心がけたのは１分に収まり、映像がテンポよく流れていくところ。

BGMはここのものを使わせてもらった。
アプリは軽快さが売りの一つなので、そのイメージに合う曲を探して充ててみた。

- - - -
今後AppStoreでは紹介動画の掲載も可能になるということなので動画制作にも徐々に慣れた方が良さそう。

ALAassetsLibraryから取得した写真を月ごとにグルーピングしたり、JPEGだけあるいはスクリーンショットだけを抜き出すといった処理が行えるライブラリを作りました。このライブラリではモデルクラスのみを提供しています（ビューはありません）。

基本

クラス図はこんな感じ。

左の３クラス（LKAssetsLibrary,LKAssetsGroup,LKAsset）がALAssetsLibraryの主要クラスのラッパーとなっていて便利メソッドが用意されている。

LKAssetの定義

@interface LKAsset : NSObject

// Properties (Status)
@property (assign, nonatomic, readonly) BOOL deleted;

// Properties (Image)
@property (weak  , nonatomic, readonly) UIImage* thumbnail;
@property (weak  , nonatomic, readonly) UIImage* aspectRatioThumbnail;
@property (weak  , nonatomic, readonly) UIImage* fullScreenImage;
@property (weak  , nonatomic, readonly) UIImage* fullResolutionImage;

// Properties (Date number)
@property (assign, nonatomic, readonly) NSTimeInterval timeInterval;
@property (assign, nonatomic, readonly) NSInteger dateTimeInteger;  // yyyyMMddHH

// Properties (ALAsset property)
@property (strong, nonatomic, readonly) NSURL* url;
@property (strong, nonatomic, readonly) CLLocation* location;
@property (strong, nonatomic, readonly) NSDate* date;
@property (strong, nonatomic, readonly) NSString* fileExtension;    // upper string JPG, PNG, ...
@property (assign, nonatomic, readonly) CGSize size;
@property (assign, nonatomic, readonly) LKAssetType type;

// Properties (Filter)
@property (assign, nonatomic, readonly) BOOL isJPEG;
@property (assign, nonatomic, readonly) BOOL isPNG;
@property (assign, nonatomic, readonly) BOOL isScreenshot;
@property (assign, nonatomic, readonly) BOOL isPhoto;
@property (assign, nonatomic, readonly) BOOL isVideo;
  :

ちなみに fullScreenImageとfullResolutionImageは回転している写真を適正に補正してくれる。

使い方の例。

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(_assetsLibraryDidSetup:)
                                                 name:LKAssetsLibraryDidSetupNotification
                                               object:nil];
    self.assetsLibrary = [LKAssetsLibrary assetsLibrary];
    [self.assetsLibrary reload];
}

ALAssetsLibraryと異なり blocksではなく通知ベースで使う。アセットの取得が済むと LKAssetsLibraryDidSetupNotification が通知されるので、後は LKAssetsGroupとLKAssetを取り出して使っていく。

- (void)_assetsLibraryDidSetup:(NSNotification*)notification
{
    [self.tableView reloadData];
}

グループのタイトルとサムネイルをテーブルのセルへ表示する例

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"GroupCell" forIndexPath:indexPath];

    LKAssetsGroup* assetsGroup = self.assetsLibrary.assetsGroups[indexPath.row];   
    cell.imageView.image = assetsGroup.posterImage;
    cell.textLabel.text = assetsGroup.description;
    return cell;
}

アセット（画像）のサムネイルをUICollectionViewCellへ表示する例

- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath
{
    AssetCell* cell = (AssetCell*)[collectionView dequeueReusableCellWithReuseIdentifier:@"AssetCell"
                                                                           forIndexPath:indexPath];
    LKAsset* asset = [self.assetsCollection assetForIndexPath:indexPath];
    cell.imageView.image = asset.thumbnail;
    return cell;
}

コレクション

さてこのライブラリの売りは基本で紹介したクラスを利用して作られた LKAssetsCollectionにある。LKAssetsCollectionは様々な条件を満たすアセットの集合を取り扱うことができる。例えばLKAssetsCollectionを使うと「月ごと」に分類された 「JPEGとPNG画像」を「日付降順でソート」したアセットの配列を作ることができる。

LKAssetsCollection
  　.entries
　　　｜
　　　｜--LKAassetsCollectionEntry（2014年5月）
　　　｜　　　.assets
　　　｜　　　　｜
　　　｜　　　　｜--LKAsset（JPEG画像　2014/05/21 10:00）
　　　｜　　　　｜--LKAsset（PNG 画像　2014/05/11 10:00）
　　　｜　　　　｜--LKAsset（JPEG画像　2014/05/01 10:00）
　　　｜　　　　：
　　　｜--LKAassetsCollectionEntry（2014年4月）
　　　｜　　　.assets
　　　｜　　　　｜
　　　｜　　　　｜--LKAsset（JPEG画像　2014/04/21 10:00）
　　　｜　　　　｜--LKAsset（PNG 画像　2014/04/11 10:00）
　　　｜　　　　｜--LKAsset（JPEG画像　2014/04/01 10:00）
　　　｜　　　　：
　　　：

LKAssetsCollectionの配下には LKAssetsCollectionEntryの配列があり、これがさらに LKAssetsの配列を持つ。

一旦コレクションが作れれば後は indexPathで末端の LKAssetを取り出せるので UITableView や UICollectionView で簡単に使うことができる。

- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath
{
    AssetCell* cell = (AssetCell*)[collectionView dequeueReusableCellWithReuseIdentifier:@"AssetCell"
                                                                           forIndexPath:indexPath];
    LKAsset* asset = [self.assetsCollection assetForIndexPath:indexPath];
    cell.imageView.image = asset.thumbnail;
    return cell;
}

LKAssetsCollectionのインターフェイス。

@interface LKAssetsCollection : NSObject

@property (nonatomic, weak  , readonly) LKAssetsGroup* group;
@property (nonatomic, strong, readonly) NSArray* entries;   // 

@property (nonatomic, strong, readonly) id <LKAssetsCollectionGrouping> grouping;
@property (nonatomic, strong) id <LKAssetsCollectionFilter> filter;
@property (nonatomic, strong) id <LKAssetsCollectionSorter> sorter;

+ (instancetype)assetsCollectionWithGroup:(LKAssetsGroup*)group grouping:(id <LKAssetsCollectionGrouping>)grouping;

@end

@class LKAsset;
@interface LKAssetsCollection (NSIndexPath)
- (LKAsset*)assetForIndexPath:(NSIndexPath*)indexPath;
@end

コレクションに含めるアセットを決める条件は３種類指定することができる。

・グルーピング　　（例）年ごと、月ごと、日ごと、時ごと
・フィルター　　　（例）JPEGのみ、PNGのみ、スクリーンショットのみ、ほか
・ソーター　　　　（例）日付昇順・降順

上記の処理を定義するためにそれぞれプロトコルが定義されている。

　LKAssetsCollectionGrouping
　LKAssetsCollectionFilter
　LKAssetsCollectionSorter

これらを実装するインスタンスを LKAssetsCollectionへ渡すことで条件に合致するアセットの集合ができあがる。

初期化の例

LKAssetsCollectionGrouping* grouping = [LKAssetsCollectionGrouping assetsCollectionGroupingWithType:self.groupingType];
   
self.assetsCollection = [LKAssetsCollection assetsCollectionWithGroup:self.assetsGroup
                          grouping:[LKAssetsCollectionDateGrouping groupingWithType:self.groupingType]];
self.assetsCollection.filter = [LKAssetsCollectionGenericFilter filterWithType:LKAssetsCollectionGenericFilterTypeJPEG|LKAssetsCollectionGenericFilterTypePNG];
self.assetsCollection.sorter = [LKAssetsCollectionDateSorter sorterAscending:NO];

LKAssetsCollectionDateGrouping や LKAssetsCollectionGenericFilter、LKAssetsCollectionDateSorter は先程のプロトコルの実装クラスになる。これらは標準で提供される。なおグルーピングと、ソースとなる LKAssetsGroupは初期設定しかできず後からは変更できない（immutable）。一方、フィルターとソーターは後から変更を適用することが可能。

LKAssetsCollectionDateGrouping で指定可能なグルーピング単位

typedef NS_ENUM(NSInteger, LKAssetsCollectionGroupingType) {
    LKAssetsCollectionGroupingTypeAll      = 0,
    LKAssetsCollectionGroupingTypeYearly   = 11,          // 年ごと
    LKAssetsCollectionGroupingTypeMonthly  = 12,          // 月ごと
    LKAssetsCollectionGroupingTypeWeekly   = 13,          // 週ごと（月曜始まり〜日曜までを１週間とみなす）
    LKAssetsCollectionGroupingTypeDaily    = 14,          // 日ごと
    LKAssetsCollectionGroupingTypeHourly   = 15,          // 時ごと
};

LKAssetsCollectionGenericFilter で指定可能なフィルタ条件。ビットORで複数指定が可能。

typedef NS_ENUM(NSUInteger, LKAssetsCollectionFilterType) {
    LKAssetsCollectionFilterTypePhoto        = (1 << 0),
    LKAssetsCollectionFilterTypeVideo        = (1 << 1),
    LKAssetsCollectionFilterTypeJPEG         = (1 << 2),
    LKAssetsCollectionFilterTypePNG          = (1 << 3),
    LKAssetsCollectionFilterTypeScreenShot   = (1 << 4),
    LKAssetsCollectionFilterTypeAll          = 0xFFFFFFFF,
};

コレクションクラスは、グルーピング・フィルター・ソーターの各プロトコルに準拠したインスタンスを利用するので、標準以外の処理を行わせたい場合はプロトコルに適合したクラスを用意すればいい（もちろん標準提供のこれらのクラスをサブクラス化しても良い）。

その他

グループやアセットの変更通知

グループやアセットが追加されたり、変更や削除された場合、LKAssetsLibraryはそれを検出して内部で持っているグループをそれに合わせて更新する。アセットの増減があった場合はコレクションにも変更が自動的に反映される。

また処理後に独自の通知も出す。

// Notifications (Update)
// store updated group into userInfo[LKAssetsLibraryGroupsKey]
extern NSString * const LKAssetsLibraryDidInsertGroupsNotification;
extern NSString * const LKAssetsLibraryDidUpdateGroupsNotification;
extern NSString * const LKAssetsLibraryDidDeleteGroupsNotification;

// Notifications (keys)
extern NSString * const LKAssetsLibraryGroupsKey;

NSNotificationの userInfoから LKAssetsLibraryGroupsKeyをキーにして追加・変更のあった（あるいは削除された）LKAssetsGroupインスタンスを取得できる。

- (void)_assetsLibraryDidInsertGroup:(NSNotification*)notification
{
    NSArray* groups = notification.userInfo[LKAssetsLibraryGroupsKey];
    NSLog(@"%s|inserted: %@", __PRETTY_FUNCTION__, groups);
}

iCloud上の写真

iCloud上で作成した共有アルバムの写真は、サムネイルは入手できるものの実体画像は取得できない場合がある。これは明示的にダウンロードする必要がある為。標準の写真アプリで閲覧（ダウンロード）してある場合はそのキャッシュが使える（表示できる）。最初のバージョンではこのケースに対応できていない（デモプログラムでもその場合、サムネイルは表示されても詳細が表示できない）。フォトストリームは自動的にダウンロードされるので大丈夫なようだ。

デモプログラム

付属のデモプログラムを実行すると最初にグループの一覧が表示される。
これは LKAssetsLibrary.assetsGroup（NSArray)を並べたもの。

グループを１つ選んでタップすると中の写真が一覧される。
グルーピング（ALL | Year | Month | Week | Day | Hour）、並び順（Ascending | Descending）、種別（All | JPEG | Screen | Video）が選べて、その場で表示が変わる。ここで先ほど説明した LKAssetsCollection を使っている。

なおビデオはサムネイルは表示されるが、詳細では表示されない（ビデオ再生を実装していないだけ）。

その他

グルーピングの Weeklyの処理はいまいちイケていないので少し遅い。大量の写真がある場合、デモでも他のグループに比べて一瞬遅れるのが分かるかもしれない。

インストール

CocoaPodsを使う。

$ pod install LKAssetsLibrary

今までプラベートなリポジトリしか使っていなかったので CocoaPodsの公式へ登録するのは初めて。先日公開された Trunkを早速使った。この辺りは下記のブログが参考になった。

CocoaPods Trunkを利用したライブラリの追加方法

ライセンス

MIT です。基本好きに使って下さい。


- - - -
ようやくモデルができた。次は選択画面を作る。これは複数選択可能なイメージピッカーみたいなやつになる予定。