# Accerciser マニュアル v0.2.0

2006
2007
2008
IBM Corporation
2010.
松澤二郎 (matsuzawa.jr@gmail.com)
2010.
日本GNOMEユーザ会 (http://www.gnome.gr.jp/)
GNOME ドキュメントプロジェクト
Eitan
Isaacson
Accerciser チーム

     eitan@ascender.com

Peter
Parente
Accerciser チーム

     pparent@us.ibm.com

Accerciser マニュアル v0.2.0
2007-06-29

Eitan Isaacson eitan@ascender.com

Accerciser チーム

このマニュアルは Accerciser バージョン 0.1.5 について説明しています。

このマニュアルは Accerciser の使用法について説明しています。

## フィードバック

バグの報告あるいは Accerciser、本マニュアルについての提案をするには、GNOME Feedback Pageの指示にしたがってください。

## はじめに

Accerciser は、GNOME デスクトップのための対話型の Python アクセシビリティ・エクスプローラです。ウィジェットを検査、制御するために AT-SPI を使用し、アプリケーションが支援技術への適切な情報を提供しているか、また自動化されたテストフレームワークであるかをチェックすることができます。Accerciser はシンプルなプラグイン・フレームワークを持っており、支援技術のカスタム・ビューを作成するためにそれを使用することができます。

本質的に、Accerciser は次世代の at-poke ツールです。

## 基本的な使用方法

### Accerciser を起動するために

以下の手順で Accerciser を起動できます。

アプリケーション・メニュー

  プログラミング Accerciser のメニュー項目を選択する。

コマンド・ライン

  コンソール・ウィンドウで以下のコマンドを入力し、Return を押下する。

  `accerciser`

### Accerciser を起動したら

Accerciser を起動すると、以下のウィンドウが表示されます。

#### Accerciser メイン・ウィンドウ

メイン・ウィンドウをAccerciser表示します。タイトルバー、メニューバー、ウィジェット・ツリー、右部プラグイン表示エリア、下部プラグイン表示エリアを含みます。メニューバーはファイル、編集、ブックマーク、表示およびヘルプメニューを含みます。

メインの Accerciser ウィンドウには以下の要素が含まれています:

メニューバー

  メニューバーから次のことが行えます。プラグインの管理、ブックマークの管理と使用、ウィジェット・ツリー・ビューのリフレッシングおよび本ヘルプ・システムの閲覧。

ウィジェット・ツリー・ビュー

  ウィジェット・ツリー・ビューはデスクトップで起動しているすべてのウィジェットを表示することができます。ウィジェットを選択することで、より詳細な検査のためにロード済みプラグインの使用が可能になります。

右部プラグイン・ビュー

  これはふたつのデフォルトのプラグイン・ビューのうちのひとつです。Accerciserを起動した時、ほとんどのプラグインはここに配置されています。プラグインのタブを下部プラグイン・ビューかデスクトップにドラッグすることで、同時にふたつ以上のプラグインを表示することができます。

下部プラグイン・ビュー

  右部プラグイン・ビューとちょうど同じように、この位置へ、あるいはこの位置からプラグインをドラッグすることができます。

### プラグイン・ビュー管理

Accerciser はプラグインを表示するふたつのモードがあります。表示プラグイン固有の表示または Control t を押下することにより、現在のビュー・モードを切り替えることができます。固有モードが有効になっている場合、すべてのプラグインは右部プラグイン・ビューにアルファベット順に配置されます。これは、Accerciser のプラグインの柔軟な空間的配置を使用しない、スクリーン・リーダのユーザにとって使い勝手が良いでしょう。固有モードが無効になっている場合は、プラグインのタブを別のプラグイン・ビューにドラッグ・アンド・ドロップでき、または新規のビューでプラグインを開くためにデスクトップにドラッグすることもできます。プラグインの配置は、プラグイン・タブから成るプラグイン・コンテキスト・メニューか、またはプラグイン設定画面から操作することができます。

## 使用方法

プラグインを使用し、ツリー・ビューに表示されるアクセス可能なウィジェットを検査するために Accerciser を使用することができます。まずは、以下の手段のひとつを使用して検査するウィジェットを選択してください:

### ツリー・ビューを通したウィジェットの選択

デスクトップ上に配置されているアクセス可能なオブジェクトの階層を移動するためにツリー・ビューを使用してください。ツリーのノードを展開するとその直属の子オブジェクトを表示することができ、反対にノードを収縮させると子オブジェクトを隠すことができます。可能であれば、各ノードはアプリケーションやウィジェットの役割に関連するアイコンおよびそのアクセス可能な名前を表示します。二列目は、要素が展開されていれば、いくつのノードが表示可能かを一覧にしています。

### ブックマークの使用

Accerciser は、以後の検証のために選択したウィジェットをブックマークすることができます。これは、例えば対象のアプリケーションをリビルドしたりして再起動しなければならないとき等に便利です。現在選択中のウィジェットをブックマークするには次の手順を行ってください。ブックマークブックマークの追加...、あるいはControl dを押下してください。

Accerciser におけるウィジェットへのブックマークは、アプリケーション名および当該アプリケーション内部のウィジェット階層におけるブックマークされたウィジェットへの"パス"によって定義されています。対象アプリケーションが異なった状態にあれば (つまりトップレベル・フレームが複数ある) 、パスが正しくないのかもしれません。

ブックマークは次のようにブックマークの編集ダイアログを開くことで管理することができます、ブックマークブックマークの編集...。

## デフォルトのプラグイン

Accerciser はデフォルトでいくつかのプラグインを備えています。これらのプラグインで、ツリー・ビュー上の現在選択中のウィジェットやその周りのものについていの様々な情報を表示できます。0.1.5 でデフォルトのプラグインは以下の通りです。

### インタフェース・ビューア

このプラグインはツリー・ビューで選択されたウィジェットの利用可能なインタフェースについての情報を表示します。サポートされないインタフェースはグレーアウトされています。展開するとインタフェースを見たり、制御したりするための機能が利用可能になります。

#### インタフェース・ビューア

選択したウィジェットがサポートするインタフェースは展開可能なものとして表示されます。

### イベントの監視

このプラグインは、ツリー・ビューで選んだウィジェット、アプリケーション、あるいはデスクトップ全体で発生するイベントのうち選択したイベントを監視します。

#### イベントの監視

イベントの監視ウィンドウの下部で、監視するイベントのタイプを選択することができます。

デスクトップ上のどこかでControl Alt lを押下することにより、以降の参照のため、最後に記録されたイベントを強調表示させることができます。このキーの組み合わせを変更するにはを参照してください。

### IPython コンソール

このプラグインは十分に鍛錬された IPython コンソールです。現在のコマンドの補完候補をみたければ Tab を押下してください。 Enter を押せば、どんな正しい Python コードも実行できます。コンソールのコマンドは、 `acc` 変数をを通じて、ツリーにおける現在選択中のウィジェットにアクセスできます。さらに、 pyatspi パッケージの関数および定数はすべてコンソール・ローカルとして利用可能です。最も重要なものは、他のアクセシビリティ・インタフェースに問い合わせを発行する関数です。例えば、 Text インタフェースに問い合わせるには、`t = acc.queryText()` と実行してください。作業ディレクトリや Python パスからのインポートも可能です。

### API ブラウザ

このプラグインは、ツリー・ビューで選択されたウィジェットがサポートするインタフェース、メソッド、属性を表示します。

#### API ブラウザ

API ブラウザ

### スクリプトの記録

Accerciserのスクリプト・レコーダは、UI テスト・スクリプトを書く目的で、ユーザが他のデスクトップアプリケーションに対するキーボード操作を記録することができます。現在プラグインは次のみっつのプラットフォームのスクリプトの世代をサポートします。すなわち、Dogtail、LDTP および Accerciser ビルトイン API。一度 "録音" ボタンを押すとあらゆるキーボード操作がスクリプトに記録され、そのスクリプトは後にスタンド・アロン・スクリプトとして実行可能です。

#### スクリプトの記録

スクリプトの記録

### クイック・セレクト

このプラグインは、対象のアプリケーションの UI を通した、ウィジェットの迅速な選択を可能にするグローバルなホットキーを提供します。 Control Alt a を押下すれば、 Accerciser でアクセス可能な、最後にフォーカスを持ったウィジェットを選択するでしょう。 Control Alt t を押下すれば、ポインタの下にあるウィジェットを選択するでしょう。

### 検証

このプラグインはアプリケーションのアクセシビリティ問題を調査し、問題の重大性および説明を含んだレポートを発行します。レポートはエラーと、共通の問題の対処のしかたについての文書を結びつけます。本プラグインは検証ルールを定義したテスト・スキーマによって拡張可能です。

検証機能を起動するためには、まずアクセシビリティ・ツリーの要素を選択します。プラグインは選択されたウィジェットとその子孫全てをテストします。次に、テストに使用するスキーマを選択します。それから Validate をクリックし、テストを開始します。テスト実行中の間、そのボタンをクリックするとテストをキャンセルします。

テストが完了すると、レポート表は全エラーの重大性と説明を表示します。表の行をダブルクリックすると、ツリー上の関連するウィジェットを表示します。要素を選択して Help をクリックすると、問題の解決方法についての情報を取得できます。

## 設定

Accerciser には設定可能な要素がいくつかある:

### プラグイン・レイアウト

Accerciser のプラグイン・レイアウトを設定する方法はふたつあります。ひとつは、編集設定を選択し、設定 画面を開きます。この画面には各セクションのタブがありますが、プラグインの一覧タブを選択してください。このセクションでは利用可能な全プラグインの一覧表示をみることができます。表示を設定するためには一覧のいずれかのプラグインを右クリックしてください。

プラグインのタブをドラッグ・アンド・ドロップすることで設定画面を抜かすことができます。プラグインのタブを、メイン・ウィンドウの下部あるいは右部にあるプラグインエリアへドラッグすることで、プラグインを移動させることができます。タブをデスクトップにドラッグすれば、新しくプラグイン・ウィンドウを作成し、そこにプラグインをドロップすることができます。

### グローバルなホットキーの設定

Accerciser のいくつかの要素はホットキーを通じて機能を有効化することができます。ホットキーの組み合わせは設定画面を通じて変更できます。編集設定を選択し、設定画面を開いてください。この画面は各セクションのタブがありますが、グローバルなホットキータブを選択してください。このセクションでは利用可能な全ホットキーの特徴の一覧表示をみることができます。お好みに応じてキー・バインディングを変更してください。

## Accerciser について

Accerciser は Eitan Isaacson (eitan@ascender.com) によって書かれました。Accerciser についてさらに情報を探すにはAccerciser GNOME Live! pageにアクセスしてください。

バグの報告あるいは本アプリケーション、本マニュアルについての提案をするには、本ドキュメントの指示にしたがってください。

ソースコードおよびバイナリフォーマットでの再頒布、使用については、改版の有無に関わらず、BSDライセンスの条項の下で許可されています。