English site 日本語サイト

5.1. StarNetworkManager

プリンタのネットワーク設定を行うためのクラスです。

• コンストラクタ

  名称	説明
  StarNetworkManager	インスタンスを生成します。

• メソッド

  名称	説明
  load	接続したプリンタから設定を取得します。
  apply	プリンタに指定した値を設定します。

各モデルにおいて機能するメソッドは以下のとおりです。

モデル/エミュレーション	mC-Print2	mC-Print3	mC-Label3
	StarPRNT	StarPRNT	StarPRNT
load	✔	✔	✔
apply	✔	✔	✔

5.1.1. StarNetworkManager

インスタンスを生成します。

• 宣言

  StarNetworkManager(String portName, Context context) throws StarIODeviceSettingException;
  

• 引数

  名称	説明	型
  portName	getPort メソッドのportNameと同じです。	String
  context	コンテキスト	android.content.Context

• 戻り値

  説明	型
  StarNetworkManager オブジェクト	StarNetworkManager

• 例外

  説明	型
  portNameにnullを設定したとき	StarIODeviceSettingException

5.1.2. load

接続したプリンタから設定を取得します。

• 宣言

  public StarNetworkSetting load() throws StarIODeviceSettingException;
  

• 引数

  なし

• 戻り値

  説明	型
  ネットワーク設定内容	StarNetworkSetting

• 例外

  説明	型
  ポートオープンに失敗したとき 誤ったportNameを設定したとき 通信エラーが発生したとき	StarIODeviceSettingException

• 実装例

  scope.launch {
      try {
          val manager = StarNetworkManager(portNameEditText.text.toString(), baseContext)
  
          val result = manager.load()
  
      } catch (e: StarIODeviceSettingException) {
  
      }
  }
  

  StarIODeviceSettingSDKを参照ください。

5.1.3. apply

added in version 1.0.0

プリンタに指定した値を設定します。

重要

本メソッド実行後、プリンターのリセットがかかります。

• 宣言

  public void apply(StarNetworkSetting setting) throws StarIODeviceSettingException;
  

• 引数

  名称	説明	型
  setting	ネットワーク設定情報	StarNetworkSetting

• 戻り値

  なし

• 例外

  説明	型
  ポートオープンに失敗したとき 誤ったportNameを設定したとき 通信エラーが発生したとき	StarIODeviceSettingException

• 実装例

  scope.launch {
      try {
          val manager = StarNetworkManager(portNameEditText.text.toString(), baseContext)
  
          val setting = StarNetworkSetting()
  
          //Example) When setting to SteadyLanSetting to "Disable"
          setting.steadyLanSetting = SteadyLanSetting.Disable
  
          manager.apply(setting)
  
      } catch (e: StarIODeviceSettingException) {
      }
  }
  

  StarIODeviceSettingSDKを参照ください。