こちらの記事は「はじめてのVoiceOver対応 - Speaker Deck」の詳細版になります

この記事から得られること

VoiceOver とは何か分かる
VoiceOver 対応でどういった知識が必要なのか分かる
VoiceOver 対応ではどんな作業をするのか分かる
VoiceOver 対応がなぜ必要なのか分かる

はじめに

Patrickが使えるように — Apple - YouTube

DJでありプロデューサーでもある全盲のPatrick Lafayette氏が、VoiceOver を使いこなしながら音楽制作や美味しそうな料理を作っている動画。すごく活き活きしててかっこいいお父さんですよねー。めっちゃ素敵

（こちらの動画はシリーズ化されているので是非他の動画もご覧になってみてください。以前まではもっと動画があったんだけど、いつの間にか減ってしまったな...）

私が VoiceOver 対応したアプリの紹介

【人事労務freee】iOSの音声読み上げ機能（VoiceOver）のデモ - YouTube

私はクライド会計ソフトなどを作っている freee という会社に務めております。（2018/07/28 現在）
freee ではクライド会計ソフト以外にもう一つメインプロダクトがあり、それがクラウド人事労務ソフトの人事労務 freee になります。こちらのサービスの iOS アプリを私の方で VoiceOver 対応したのでそこで得た知見をこちらの記事にしようと思いました。

これから VoiceOver 対応を進めるという方は「面倒なことをたくさんしなくてはならないのでは？」と感じているかもしれませんが、カスタマイズの度合いにもよりますが、ちょっとした label や hint を正しく設定してあげるだけで大概は済むはずです。

（ちなみに公式ページには VoiceOverに対応されたアプリが紹介されており、頑張ればここでフィーチャーされたりするかも？）

そもそも VoiceOver とは？

VoiceOver とは、macOS、iOS、tvOS、watchOS に内蔵されているスクリーンリーダーのことです。（本記事ではこれらの OS のうち、 iOS における VoiceOver について話したいと思います）
VoiceOver がアプリのUIとユーザのタッチの間の仲介役となり、画面上で起きていることや情報を音声で読み上げてくれることで、端末の操作を補助し、アクセシビリティを高めてくれます。

Apple には視覚のアクセシビリティという公式ページがあり、そこには以下のように書かれています。

パーソナルなデバイスを、すべての人が使えるように。

世界で最もパーソナルなデバイスは、すべての人が使えるように設計されました。だから、視覚に障がいのある方がみんなとセルフィーを撮ることも、聴覚に障がいのある方がお母さんに国際電話をかけることも、首から下の体を動かせない方が友だちにテキストメッセージを送ることもできます。

VoiceOver には「すべての人が使えるように」するための機能が組み込まれており、「視覚に障がいがある方」と「アプリ」を VoiceOver によって繋ぐことができます。（逆をいえば VoiceOver 対応がなされていないアプリや機能は「真っ暗」と言えるのかもしれません）

Auditing Your Apps for Accessibility - WWDC 2016 - Videos - Apple Developer p.17

どうやって VoiceOver は使うの？

詳細は以下の参考をご覧いただければよいですが、ざっくり説明します。

VoiceOver を On にするには？
- 「設定」＞「一般」＞「アクセシビリティ」＞「VoiceOver」＞ On
カーソルを移動するには？
- 1本指で左右にスワイプ
決定するには？
- 1本指でダブルタップ
ホームへ移動には？（iPhoneX の場合）
- 1本指で画面の下部を下から上にスワイプしたまま「ピコっ」と鳴るので手を離すと移動する
- （初め分からず設定画面から抜け出せなかった...）
次のページへ移動（ホーム画面のページ移動のときなど）
- 3本指で左右にスワイプ

だいたいこれらのジェスチャーでなんとかなる。ショートカットは設定しておくと非常に便利です。

参考

VoiceOver 対応はどういったときに必要になるの？

iOSアクセシビリティプログラミングガイド p.6 に書かれている通りカスタム度合いによって対応範囲が変わります。

CALayer や OpenGL を使用してUIを提供していることでアクセシイビリティ情報（後述の Label, Traits, Frame など）が無く読み上げられない
UIKit を使用しているがカスタムのコントローラやビューでUIを提供していて正しく読み上げられない
読み上げられているが意図した読み上げられ方ではない
UIKit 側では適切な読み上げ方が判断できない

これらのケースを具体的な例をあげながら対応方法を説明します。

対応する前に知っておくべきこと

アクセシビリティ属性

UIAccessibility プログラミングインターフェイスを実装することで VoiceOver に必要な情報を伝えられアプリをアクセシブルにすることが可能になります。このインターフェースを一部の UIKit でデフォルトで実装されているため最小限の対応で済みますが、上記の例のようにカスタム度合いによって適宜アプリ側で実装してあげる必要があります。その際に実装に必要になるのが以下のアクセシビリティ属性です。

デフォルト実装されているUIコンポーネントとして分かりやす例が UIDatePicker です。
アラームアプリの時刻のピッカーにフォーカスがあたると、

"x時。ピッカー項目。調整可能。値を調整するには1本指で上または下にスワイプします"

と読み上げられます。

これは、

"[Value] [Label] [Trait] [Hint]"

を指しています。それぞれの属性について詳しく説明していきます。

accessibilityLabel

UI要素のラベルを表します。

UISwitch は「切り替えボタン」
UITextFiled は「テキストフィールド」
UIButton の title

がラベルに相当します。

● Label（ラベル）。コントロールやビューを簡潔に説明する、短く、ローカライズされた単語またはフレーズですが、要素のタイプは識別しません。例としては、「Add（追加）」や「Play（再生）」などです。

accessibilityTraits

UI要素の種類、状態、実行可能な振る舞い、を複数選択して表します。

デフォルトでセットされている trait
- UIButton は button
- UIImageView であれば image
- UIDatePicker であれば adjustable
動的に変わる trait
- UITableViewCell や UICollectionViewCell の isSelected が true になると traits に selected がセットされる

● Traits（特性）。それぞれが要素の状態、動作、または使用方法の特徴の1つを説明する個々の特性を、1つ以上組み合わせたものです。たとえば、キーボードのキーのように動作する要素が現在選択されている場合、KeyboardKey特性およびSelected特性の組み合わせで特徴付けることがで
きます。

accessibilityHint

Label と Trais だけでは補えない情報を付与します。UIButton は適切な Label と Trait が入っていれば認識できますが、 UIDatePicker は表示されたはいいがどのように編集していいかは分かりません。そのためデフォルトで「値を調整するには1本指で上または下にスワイプします」というヒントが入っています。

● Hint（ヒント）。要素に対するアクションの結果を説明する、短く、ローカライズされたフレーズです。例としては、「Adds a title（タイトルを追加）」や「Opens the shopping list（ショッピングリストを開く）」などです。

accessibilityValue

UIButton の場合は空です。値を持つような Picker や Swich、Progress などは値が入ります。

● Value（値）。値がラベルで表されていない場合の、要素の現在の値です。たとえば、スライダのラベルは「Speed（速度）」ですが、その現在の値は「50%」であることなどが考えられます。

accessibilityFrame

読んでおくと良い/見ておくと良い資料

上記で説明したことは最低限のことです。説明しきれていないところも多々あるので iOSアクセシビリティプログラミングガイドだけでも一読することをオススメします。

VoiceOver 対応でやったこと

やっと本題です。具体例を上げながら対応方法を説明していきます。

画像ボタンには label セットが必須

任意の画像を使ったボタンを読み上げてみると「ボタン」とだけ trait が読み上げられます。このままではどういったボタンなのか分からず怖くてタップできません。そういった場合にこの例だと "ブックマーク" とラベルをセットしてあげることで「ブックマークボタン」と読み上げてくれるようになります。

意識していないと平気で発生するし、詰む可能性が高いので注意が必要
HTMLでいう img タグに alt 属性が入ってのと同じ
system type の画像ボタンは不要

意図しない読み上げられ方をした場合にも適切な label に変更

上記の例はリファレンスやプログラミングガイドにも書かれている内容ですが、その他にも accessibilityLabel を独自に設定してあげたほうが良いケースがあります。それは、こちらが意図しない形で読み上げられてしまっているケースです。

例えば、「6/5〜6/8」と期間が書かれたラベルがあったとします。この場合、「ろくがついつかからろくがつようか」と読まれることをこちらとしては想定していますが、実際には 「ろくスラッシュごろくスラッシュはち」 といったように、「/」は「すらっしゅ」、「〜」は読み飛ばされ読み上げられてしまいます。利用しているアプリ内でユーザ自身で設定した期間などだったら理解できるかもしれませんが、アプリ側から表示されたものだった場合は、「/」で日付であることはギリギリ理解できても、「〜」が読み飛ばせれてしまっているため期間であることを理解できない可能性があります。

こういった場合に accessibilityLabel に「6月5日から6月8日」と設定 しておくと「ろくがついつかからろくがつようか」と意図した形で読み上げられるようになります。
（ローカライズは適宜）

traits は振る舞いに沿って設定する①

設定 > Apple ID > サインアウトセル

「サインアウト」セルのようなケースです。UITableViewCell にはデフォルトでは traits は何も指定されていません。このケースだと traits に button が指定されていることが望ましいが、無指定のままだとフォーカスが当たっても「ボタン」と読み上げられず、利用者にアクセシブルであることが伝わりにくくなってしまうため、適切な trails を追加してあげる必要があります。
（accessoryType が指定されている場合にはタップ可能とOS側で判断され、 trails に button を追加しなくても「ボタン」と読み上げてくれます）

traits は振る舞いに沿って設定する②

App Store > マイアカウント > アカウント > サービス規約

同じような形状のセルでも button を指定してあげれば良いとは限りません。以下のセルはタップすると Web ページが表示されます。そのため適切な trait は button ではなく link になります。

hint がないと詰んでしまうかも

カレンダー > 予定追加 > 開始/終了セル

カレンダーアプリの開始日時や終了日時はタップすることでピッカーが表示されます。この編集方法を開始/終了の日付セルにフォーカスを当てたときに「編集するにはダブルタップします」と読み上げられるよう hint がセットされています。
このように label や trait では伝えきれない部分を hint を用いて補ってあげる必要があります。

extension を作っておくと便利

読み上げメソッド

extension String {
    func say() {
        UIAccessibilityPostNotification(UIAccessibilityAnnouncementNotification, self)
    }
}

フォーカス移動メソッド

extension UIView {
    func focus() {
        UIAccessibilityPostNotification(UIAccessibilityLayoutChangedNotification, self)
    }
}

Accessibility Inspector をうまく使おう

Inspection

Xcode > Open Developer Tool > Accessibility Inspector > Inspection Tab より利用できます

Inspection を使用することで VoiceOver を実機で使用せずとも label や value、hint の情報が分かるので便利です。
（ただ最終的には実際の使用感を確かめるために実機での確認は必須ですけど）

Audit

Xcode > Open Developer Tool > Accessibility Inspector > Audit Tab > Run Audit より利用できます

VoiceOver に限らずアクセシビリティ対応全般の不備のチェックが可能で、「description がないよ」、「タップエリアが狭いよ」、「Dynamic Type に対応されていないよ」などといったこを教えてくれます。
なので初めにざっと流してみると良いかもしれません。

（ただ、なぜか他のアプリに影響が出たりして、僕の環境だと Accessibility Inspector 起動中は Alfred が動かなくなったりします）

なぜ freee は VoiceOver 対応するのか

少し手を加えてあげるだけで利用可能なユーザを増やすことができる
おまけに、UI設計の知見が深まる
freeeは事業として取り組んでいる
全盲のエンジニアも社内に居てアクセシビリティ向上に取り組んでいる

この言葉は同僚の全盲のエンジニアから頂いた言葉です。僕はこの言葉でやっていく気持ちが高まりました🔥🔥🔥
この言葉と共にこれから VoiceOver 対応される方の一助にあれば幸いです。

はじめての VoiceOver 対応