ハプティクス ペン検証ガイド
この記事では、ハプティクス ペン検証ツールを使用して、必要な両方 テストケース 1 と 2 ) とオプションの (テストケース 3 および 4) ハプティクス ペンの機能を検証する手順について説明します。
テストの前提条件
[ハプティックス ペン検証ツール] をインストールする
- [ハプティックス ペン検証ツール] をインストールする
- ダウンロードした HapticPenValidationTool ファイルを右クリックします。
- [プロパティ] を選択します。
- [デジタル署名] タブを選択します。
- 一覧で署名を選択します。
- [詳細] ボタンをクリックします。
- [証明書の表示] ボタンをクリックします。
- [証明書のインストール...] ボタンをクリックします。
- [ローカルコンピューター] を選択し、[次へ] をクリックします。
- [証明書をすべて次のストアに配置する] を選び、[参照...] をクリックします。
- [信頼されたユーザー] を選択し、 [OK] をクリックします。
- [次へ] ボタンをクリックします。
- [完了] ボタンをクリックします。
- HapticPenValidationTool.appx をダブルクリックし、[インストール] ボタンをクリックします。
テスト ケース
各シナリオでテスト ケースを実行するには、次の手順に従います。
テストケース 1: ペンが適切に必要なハプティック機能を報告することを検証する
- ハプティック ペン検証ツールを起動し、[Check Required Waveforms] (必要な波形の確認) タブに移動する
- メイン キャンバスの範囲内にペンを移動する
テスト ケース 1 の予想される結果
次のテキストが表示されます。
成功: [サポート済み] をクリックする
成功: InkContinuous がサポートされている
テストケース 1 のエラー ケース
| エラー ケース | エラーの理由 |
|---|---|
| 「エラー: 現在のデバイスはペンではありません」というテキストが表示される | 現在のポインター デバイスがペンとして認識されない |
| 「エラー: 高度なペン機能がサポートされていません」というテキストが表示される | 現在のペンは、触覚的フィードバックなどの高度な機能をサポートしていません。 |
| 「エラー: このペンは触覚的フィードバックを提供しません」というテキストが表示される | 現在のペンはハプティクスをサポートしていません |
| 「エラー: クリックがサポートされていません」というテキストが表示される | 現在のペンは、WAVEFORM_CLICK をサポートしていません |
| 「エラー: InkContinuous がサポートされていません」というテキストが表示される | 現在のペンは、WAVEFORM_INKCONTINUOUS をサポートしていません |
エラー メッセージの例:
テストケース 2: 必要な相互作用の検証
- テスト 1 に成功する
- 検証ツールの [Check Required Interactions] (必要な対話の確認) タブに移動する
- ペンを使用して [Send Click Feedback] (クリック フィードバックの送信) ボタンをタップする
- Inkcontinuous テスト のボックス内にペンを置き、1 秒以上移動して、画面との接点を維持します。
- インクと相互作用のフィードバック テスト のボックス内にペンを置き、1 秒移動して、画面との接点を維持します。
- クリックの波形が表示されたら、ペンを使用して画面をタッチしたまま、1 秒間移動しないようにします。
- ボックス内のペンの移動を続行する
テスト ケース 2 の予想される結果
- "クリック" 波形は、手順 3 のボタンをタップしたときにペンによって再生されます。
- 手順 4 でペンの先端が接触したときに、"InkContinuous" 波形は再生され始め、その後、ペンが画面に接触した 1 秒後に停止します。
- 手順 5 でペンの先端が画面に接触したときに、"InkContinuous" 波形が再生されます。
- "クリック" 波形は、手順 5 のボックスでペンを 1 秒間ドラッグした後に再生されます。
- "InkContinuous" 波形は、手順 7 でペンを移動すると再生されます。
テスト ケース 1 のエラー ケース
| エラー ケース | エラーの理由 |
|---|---|
| 手順 3 でペンでボタンをタップしても、ハプティク フィードバックは認識されません。 | ペンは WAVEFORM_CLICK 波形を正しく再生できませんでした |
| 手順 7でペンを移動しても、ハプティック フィードバックは認識されません | ペンが WAVEFORM_INKCONTINUOUS 波形を正しく再生できませんでした |
| ハプティック フィードバックは、手順 4 で 1 秒間の移動後に停止しません | ペンが WAVEFORM_STOP に正しく応答しませんでした |
| 手順 5 でペンを移動しても、ハプティック フィードバックは認識されません | ペンが WAVEFORM_INKCONTINUOUS 波形を正しく再生できませんでした |
| "クリック" 波形は 手順 5 で 1 秒間の移動後に再生されません | ペンは WAVEFORM_CLICK 波形を正しく再生できませんでした |
| 手順 7 でペンを移動しても、ハプティック フィードバックは認識されません | 手順 3 と 手順 5 でハプティック フィードバックが表示された場合、これは、ペンが相互作用波形によって中断されたときにインク波形を正しく再開しないことを示します。 そうでない場合は、ペンが WAVEFORM_INKCONTINUOUS の波形を正しく再生できなかったことを示します。 |
テスト ケース 3: オプションの波形を確認する
このセクションに含まれるテストはオプションであり、現在のペンが関連する波形をサポートしている場合にのみ使用してください。
- テスト 1 および テスト 2 に成功する
- 検証ツールの [Check Optional Waveforms] (オプションの波形の確認) タブに移動する
- [オプションの継続波形] セクションのドロップダウンで、テストする連続波形を選択する
- [オプションの連続する波形] セクションのボックスにペンを置き、移動する
- 画面からペンを持ち上げる
- [オプションの相互作用波形] セクションのドロップダウンで、テストする相互作用波形を選択する
- ペンを使用して [Send Interaction Feedback] (相互作用フィードバックの送信) ボタンをタップする
テスト ケース 3 の予想される結果
- 手順 4 でペンの先端が接触すると、選択した波形が再生され始め、手順 5 でペンを持ち上げると停止します。
- 選択した波形は、手順 7 のボタンをタップしたときにペンによって再生されます。
テスト ケース 3 のエラー ケース
| エラー ケース | エラーの理由 |
|---|---|
| 手順 7でペンを移動しても、ハプティック フィードバックは認識されません | ペンは、選択した波形を正しく再生できませんでした |
| ハプティック フィードバックが、手順 5 の画面から持ち上げたときに停止しません | 波形の再生を停止することで、ペンが画面からリフトされているペンの先端に適切に反応しませんでした |
| 手順 7 でペンでボタンをタップしても、ハプティク フィードバックが認識されません | ペンは、選択した波形を正しく再生できませんでした |
テストケース 4: オプションの相互作用の検証
このセクションに含まれるテストはオプションであり、現在のペンが関連する機能をサポートしている場合にのみ使用してください。
- テスト 1 および テスト 2 に成功する
- 検証ツールの [Check Optional Interactions] (オプションの対話の確認) タブに移動する
- ペンを使用して [Send Click Feedback With Intensity] (輝度を用いてクリック フィードバックを送信) ボタンを押す
- [輝度] スライダーを変更する
- ペンを使用して [Send Click Feedback With Intensity] (強度を用いてクリック フィードバックを送信) ボタンを再度押す
- [継続的なフィードバック テストを自動的に停止] の左側のボックスにペンを置き、移動する
- 画面からペンを範囲外に持ち上げる
- [継続的なフィードバック テストを自動的に停止] の右側のボックスにペンの先端を置き、移動する
- ペンを使用して [Send Repeated Feedback] (繰り返しフィードバックの送信) ボタンを押す
- ペンを使用して [Send Repeated Feedback With One Second Pause] (1 秒停止を使って繰り返しフィードバックの送信) ボタンを押す
テスト ケース 4 の予想される結果
- クリック波形は、手順 3 でボタンが押されたときに、100% の輝度で再生されます。
- クリック波形は、手順 3 でボタンが押されたときに、選択された輝度で再生されます。
- 手順 6 でペンの先端が画面に接触したときに、"InkContinuous" 波形が再生されます。
- 手順 7 で画面からペンを持ち上げたときに、"InkContinuous" 波形が停止します。
- 手順 8 でペンの先端が右側のボックスに置かれ、移動したときに、"InkContinuous" 波形は再生されません。
- クリック波形は、手順 9 でボタンが押されたときに、3 回再生されます。
- 手順 10 でボタンが押されると、クリック波形は 3 回再生され、それぞれの間に1秒の一時停止が付きます。
テスト ケース 4 のエラー ケース
| エラー ケース | エラーの理由 |
|---|---|
| クリック波形は、手順 5 でボタンが押されたときに、選択された輝度で再生されません。 | ペンが輝度機能を正しく実装しませんでした |
| 手順 6 でペンを移動しても、ハプティック フィードバックは認識されません | ペンが WAVEFORM_INKCONTINUOUS 波形を正しく再生できませんでした |
| ハプティック フィードバックが、手順 7 の画面から持ち上げたときに停止しません | 波形の再生を停止することで、ペンが画面からリフトされているペンの先端に適切に反応しませんでした |
| InkContinuous 波形は、手順 8 でペンが配置されたときに再生されます | 画面の範囲を離れると、ペンはその波形の状態を適切にクリアできませんでした |
| クリック波形は、手順 9 でボタンが押されたときに、3 回再生されませんでした | ペンが繰り返し回数機能を正しく実装しませんでした |
| 手順 10 でボタンが押されると、クリック波形は 3 回再生され、それぞれの間に1秒の一時停止が付きませんでした | ペンは Retrigger Period 機能を正しく実装しませんでした |