addRid static method

Future<void> addRid(
  1. String rid
)

Adds an RID to the newPOS device.

This function returns a Future<void>, which completes when the RID has been added successfully or when an error occurs.

If the RID cannot be added, the function throws a FlutterPosException.

Parameters:

  • rid (required): The RID to be added.

Example:

await FlutterNewposSdk.addRid('A000000003');

Throws:

  • FlutterPosException with the code ADD_RID_TIMEOUT if the RID cannot be added within the timeout period.
  • FlutterPosException with the code ADD_RID_FAILURE if an unknown error occurs while adding the RID.
  • FlutterPosException with the code ADD_RID_FAILURE if the RID is already added.

Implementation

static Future<void> addRid(String rid) async {
  /// Stream method
  final stream = FlutterNewposSdk._methodStream.stream
      .where((m) => m.method == 'OnAddRidSuccess')
      .map((m) {
    return m.arguments as bool;
  });
  try {
    final methodResult = await _invokeMethod(
      'addRid',
      rid,
    );

    final result = methodResult as bool;

    if (!result) {
      throw const FlutterPosException(
        code: 'ADD_RID_FAILURE',
        message: 'Exception adding RID',
      );
    }
    final streamOutput = await getFirstResultInStream(
      stream,
      const Duration(seconds: 2),
    );
    if (streamOutput == false) {
      throw const FlutterPosException(
        code: 'ADD_RID_FAILURE',
        message: 'Exception adding RID',
      );
    }
  } on TimeoutException {
    throw const FlutterPosException(
      code: 'ADD_RID_TIMEOUT',
      message: 'Timeout adding RID',
    );
  } catch (e) {
    throw const FlutterPosException(
      code: 'ADD_RID_FAILURE',
      message: 'Exception adding RID',
    );
  }
}