4.8. ILedCommandBuilder

added in version 1.13.0

LED制御用コマンドを生成する機能を提供するインターフェイスです。

列挙体

名称

説明

Led

LED指定定数

メソッド

名称

説明

appendAutomaticBlinkMode

プレゼンター／ベゼル動作中のLED点滅モードの設定コマンドを生成し、コマンドバッファに追加します

appendAutomaticBlinkInterval

プレゼンター／ベゼル動作中のLEDのON/OFF時間設定コマンドを生成し、コマンドバッファに追加します。

appendBlink

LED点滅実行コマンドを生成し、コマンドバッファに追加します。

getCommands

コマンドバッファ（生成したコマンド）を取得します。

本インターフェイスはLED表示器付きモデル専用です。各モデルにおいて機能するメソッドは以下のとおりです。

モデル/エミュレーション	TUP500	SK1-211/221/V211	SK1-211/221/V211 Presenter	SK1-311/321/V311	SK1-311/V311 Presenter
モデル/エミュレーション	StarLine	StarPRNT	StarPRNT	StarPRNT	StarPRNT
appendAutomaticBlinkMode	✔	✔	✔	✔	✔
appendAutomaticBlinkInterval	✔	✔	✔[1]	✔	✔[1]
appendBlink	✔	-	✔	-	✔
getCommands	✔	✔	✔	✔	✔

[1]	ファームウェアバージョン1.0では、onTime、offTimeを0に指定した場合、100ミリ秒に設定されます。

4.8.1. Led

added in version 1.13.0

LED指定定数

宣言

enum Led {
    Printing,
    Error,
    Idle
}

定数

名称

説明

Printing

印字、プレゼンター／ベゼル動作中を示すLED

Error

エラー中を示すLED

Idle

待機中を示すLED

4.8.2. appendAutomaticBlinkMode

added in version 1.13.0

プレゼンター／ベゼル動作中のLED点滅モードの設定コマンドを生成し、コマンドバッファに追加します。

宣言

void appendAutomaticBlinkMode(Led... led);

引数

名称

説明

型

led

LED指定定数

点滅を行うLEDを指定します。

引数に何も指定しない場合、点滅は実行されません。

Led

led引数に設定可能なパラメータの組み合わせは以下のとおりです。

LedModel

設定可能なパラメータの組み合わせ

Star

Printing

Error

Printing, Error

SK

Printing

Error

Printing, Error

Printing, Error, Idle
戻り値

なし
例外

クラス

説明

IllegalArgumentException

設定不可能なパラメータの組み合わせが指定されている場合

実装例

private void print() {
    ...

    Led[] leds;
    switch (mAutomaticBlinkLedControlSpinner.getSelectedItemPosition()) {
        default:
        case 0:
        leds = new Led[] { Led.Printing, Led.Error };
        break;
        case 1:
        leds = new Led[] { Led.Printing };
        break;
        case 2:
        leds = new Led[] { Led.Error };
        break;
        case 3:
        leds = new Led[] { };
        break;
        case 4:
        leds = new Led[] { Led.Printing, Led.Error, Led.Idle };
        break;
    }

    LedModel model = ModelCapability.getLedModel(mPrinterSettings.getModelIndex());
    ILedCommandBuilder ledBuilder = StarIoExt.createLedCommandBuilder(model);

    try {
        ledBuilder.appendAutomaticBlinkMode(leds);

        List ledList = Arrays.asList(leds);

        if (ledList.contains(Led.Printing)) {
        ledBuilder.appendAutomaticBlinkInterval(Led.Printing, printingLedOnTime, printingLedOffTime);
        }

        if (ledList.contains(Led.Error)) {
        ledBuilder.appendAutomaticBlinkInterval(Led.Error, errorLedOnTime, errorLedOffTime);
        }

        if (ledList.contains(Led.Idle)) {
        ledBuilder.appendAutomaticBlinkInterval(Led.Idle, idleLedOnTime, idleLedOffTime);
        }
    }
    catch (IllegalArgumentException e) {
        ...
    }

    ...
}

LedFragment.javaを参照ください。

4.8.3. appendAutomaticBlinkInterval

added in version 1.13.0

プレゼンター／ベゼル動作中のLEDのON/OFF時間設定コマンドを生成し、コマンドバッファに追加します。

宣言

void appendAutomaticBlinkInterval(Led led, int onTime, int offTime);

引数

名称

説明

型

led

LED指定定数

点滅を行うLEDを指定します。

Led

onTime

オン時間（1ミリ秒単位）

設定可能範囲：0 - 25500

int

offTime

オフ時間（1ミリ秒単位）

設定可能範囲：0 - 25500

int

led引数に設定可能なパラメータは以下のとおりです。

LedModel

設定可能パラメータ

Star

Printing

Error

SK

Printing

Error

Idle

戻り値

なし
例外

クラス

説明

IllegalArgumentException

設定可能範囲外のパラメータが指定されている場合

実装例
- appendAutomaticBlinkMode の実装例を参照ください。*

4.8.4. appendBlink

added in version 1.13.0

LED点滅実行コマンドを生成し、コマンドバッファに追加します。

宣言

void appendBlink(Led led, int repeat, int onTime, int offTime);

引数

名称

説明

型

led

LED指定定数

点滅を行うLEDを指定します。

Led

repeat

繰り返し回数

設定可能範囲：0以上

int

onTime

オン時間（1ミリ秒単位）

設定可能範囲：1 - 25500

int

offTime

オフ時間（1ミリ秒単位）

設定可能範囲：1 - 25500

int

led引数に設定可能なパラメータは以下のとおりです。

LedModel

設定可能パラメータ

Star

Printing

Error

SK

Printing

Error

Idle

戻り値

なし
例外

クラス

説明

IllegalArgumentException

設定可能範囲外のパラメータが指定されている場合

実装例

private void blinkLed() {
    mProgressDialog.show();

    Led led;

    switch (mBlinkLedControlSpinner.getSelectedItemPosition()) {
        default:
        case 0:
        led = Led.Printing;
        break;
        case 1:
        led = Led.Error;
        break;
    }

    ...

    LedModel model = ModelCapability.getLedModel(mPrinterSettings.getModelIndex());
    ILedCommandBuilder builder = StarIoExt.createLedCommandBuilder(model);

    try {
        builder.appendBlink(led, repeat, onTime, offTime);
    }
    catch (IllegalArgumentException e) {
        ...
    }

    byte[] commands = builder.getCommands();
}

LedFragment.javaを参照ください。

4.8.5. getCommands

added in version 1.13.0

コマンドバッファ（生成したコマンド）を取得します。

宣言
byte[] getCommands();
引数

なし
戻り値

説明

型

コマンドバッファ（生成したコマンド）

byte[]