Standalone Capture

allprojects {
    repositories {
        maven {
            // Sensibill SDK repository
            url 'https://maven.pkg.github.com/getsensibill/sdk-android'
                credentials {
                    username 'to be provided by sensibill'
                    password 'to be provided by sensibill'
                }
        }
    }
}

dependencies {
    // ...

    // See the rest of the documentation for the most up to date version
    def sensibillSdkVersion = 'X.X.X'

    // Standalone Capture Module
    implementation "com.getsensibill:sensibill-capture-standalone:$sensibillSdkVersion"

    // ...
}

class MyActivity : AppCompatActivity() {
    // ...

    // ---------- Using `startActivityForResult` ----------
    private fun launchCapture() {
        // Create configuration object if required
        val config = CaptureConfig(
            allowFlashToggling = false,
            defaultFlashMode = FlashMode.FLASH_MODE_OFF,
            maxPages = 5,
            enableLongCapture = false,
            enableSecureWindow = true
        )

        // Create intent and attach config
        val intent = Intent(this, CaptureStandaloneActivity::class.java).apply {
            putExtra(CaptureStandaloneActivity.EXTRA_CAPTURE_CONFIG, config)
        }

        // Start the capture activity
        startActivityForResult(intent, REQUEST_CODE_TO_CAPTURE)
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        when (requestCode) {
            REQUEST_CODE_TO_CAPTURE -> {
                // See next section for handling the result
            }
            else -> super.onActivityResult(requestCode, resultCode, data)
        }
    }

    companion object {
        private const val REQUEST_CODE_TO_CAPTURE = 0x123
    }

    // ---------- Using `registerForActivityResult` ----------
    private lateinit var launcher: ActivityResultLauncher<CaptureConfig>

    private fun registerForCaptureResult() {
        val contract = CaptureImages()
        launcher = registerForActivityResult(contract) { result ->
            // See next section for handling the result
        }
    }

    private fun launchCaptureWithRegistration() {
        launcher.launch(CaptureConfig())
    }

}

public class MyActivity extends AppCompatActivity {
    private static final int REQUEST_CODE_TO_CAPTURE = 0x123;

    // ...

    // ---------- Using `startActivityForResult` ----------
    private void launchCapture() {
        // Create configuration object if required
        final CaptureConfig config = new CaptureConfig(
                false,
                FlashMode.FLASH_MODE_OFF,
                true,
                true,
                true,
                true,
                true,
                true,
                5,
                false,
                true,
                true,
                true,
                true
        );

        // Create intent and attach config
        final Intent intent = new Intent(this, CaptureStandaloneActivity.class);
        intent.putExtra(CaptureStandaloneActivity.EXTRA_CAPTURE_CONFIG, config);

        // Start the capture activity
        startActivityForResult(intent, REQUEST_CODE_TO_CAPTURE);
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable @org.jetbrains.annotations.Nullable Intent data) {
        if (requestCode == REQUEST_CODE_TO_CAPTURE) {
            // See next section for handling the result
        } else {
            super.onActivityResult(requestCode, resultCode, data);
        }

    }

    // ---------- Using `registerForActivityResult` ----------
    private ActivityResultLauncher<CaptureConfig> launcher;

    private void registerForCaptureResult() {
        CaptureImages contract = new CaptureImages();

        launcher = registerForActivityResult(contract, new ActivityResultCallback<BareCapturedReceiptData[]>() {
            @Override
            public void onActivityResult(BareCapturedReceiptData[] result) {
                // See next section for handling the result
            }
        });
    }

    private void launchCaptureWithRegistration() {
        launcher.launch(new CaptureConfig());
    }

    // ...
}

// ---------- Using `startActivityForResult` ----------
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    when (requestCode) {
        REQUEST_CODE_TO_CAPTURE -> {
            // Result is OK when the flow was completed and images were captured
            if (resultCode == Activity.RESULT_OK && data != null) {
                // Retrieve captured images
                val capturedImages = data.getSerializableExtra(CaptureStandaloneActivity.EXTRA_CAPTURED_RECEIPTS)
                    as Array<BareCapturedReceiptData>

                // Process images
                // ...

                // *Important* clean up images
                capturedImages.forEach { it.cleanup() }
            } else {
                // Capture flow was cancelled
                Toast.makeText(this, "No images captured", Toast.LENGTH_LONG).show()
            }
        }
        else -> super.onActivityResult(requestCode, resultCode, data)
    }
}

// ---------- Using `registerForActivityResult` ----------
private fun registerForCaptureResult() {
    val contract = CaptureImages()
    launcher = registerForActivityResult(contract) { capturedImages ->
        if (capturedImages != null) {
            // Process images
            // ...

            // *Important* clean up images
            capturedImages.forEach { it.cleanup() }
        } else {
            // The user cancelled the capture flow
            Toast.makeText(this, "No images captured", Toast.LENGTH_LONG).show()
        }
    }
}

// ---------- Using `startActivityForResult` ----------
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    if (requestCode == REQUEST_CODE_TO_CAPTURE) {
        if (resultCode == Activity.RESULT_OK && data != null) {
            // Retrieve captured images
            BareCapturedReceiptData[] capturedImages = (BareCapturedReceiptData[]) data.getSerializableExtra(CaptureStandaloneActivity.EXTRA_CAPTURED_RECEIPTS);

            // Process images
            // ...

            // *Important* clean up images
            for (BareCapturedReceiptData capturedImage : capturedImages) {
                capturedImage.cleanup();
            }
        } else {
            // Capture flow was cancelled
            Toast.makeText(this, "No images captured", Toast.LENGTH_LONG).show();
        }
    } else {
        super.onActivityResult(requestCode, resultCode, data);
    }
}

// ---------- Using `registerForActivityResult` ----------
private void registerForCaptureResult() {
    CaptureImages contract = new CaptureImages();
    launcher = registerForActivityResult(contract, new ActivityResultCallback<BareCapturedReceiptData[]>() {
        @Override
        public void onActivityResult(BareCapturedReceiptData[] result) {
            if (result != null) {
                // Process images
                // ...

                // *Important* clean up images
                for (BareCapturedReceiptData capturedImage : result) {
                    capturedImage.cleanup();
                }
            } else {
                // Capture flow was cancelled
                Toast.makeText(MyActivity.this, "No images captured", Toast.LENGTH_LONG).show();
            }
        }
    });
}