PiQAlike Android

This repository contains binary distributions of PiQAlike Android framework.

If you have any questions, comments, or issues related to PiQAlike, Please contact the team by emailing support@streamoid.com.

PiQAlike

PiQAlike is an Android framework for visual search recommendations in fashion. PiQAlike framework provided by Streamoid Technologies lets you seemlessly integrate visual search feature into your native android applications

• what is visual search in fashion ?
• That perfect summer dress you saw in a magazine or those shoes that the woman was wearing at the coffee shop this morning. Just take a photo and find similar products in your app using PiQAlike SDK.

Installation

Binary

You may download AAR releases here.

JCenter

Add JCenter to your build file's list of repositories.

repositories {
    jcenter()
}

to use the JCenter Repository

dependencies {
    ...
    compile 'com.streamoid.sdk.piqalike:piqalikesdk:1.1.0'
    ...
}

Add following to manifest application

 <application
  ...
  tools:replace="android:theme"
  ...
  >

Verifying PiQAlike Configuration

Once you have finished adding PiQAlike framework to your project, you can test your configuration by importing the dependencies and connecting a client to the PiQAlike cloud. To do so, add following code to your Application class. (note that you must substitute the client name and client token placeholder text with your actual values, in order to get these values please contact us at support@streamoid.com):

Simple Intialization

 piqALike.initialize(VENDOR, TOKEN, new com.streamoid.sdk.piqalike.Callback() {
                @Override
                public void onSuccess(String response) {
                    //Connection Success
                }

                @Override
                public void onFail(String error) {
                    //Connection Failed

                }
            });

Custom Intialization

                PiqALikeParams params=new PiqALikeParams();
                //Customize themeColor,etc..
                params.setThemeColor(Color.MAGENTA);
                params.setTextColor(Color.WHITE);
                
                //Customize UI elements in Camera screen
                params.setDrawableCameraRotate(R.mipmap.ic_camera_rotate);
                params.setDrawableBackButton(R.mipmap.demo_ic_back);
                params.setDrawableFlashAuto(R.mipmap.ic_flash_auto);
                params.setDrawableFlashOff(R.mipmap.ic_flashoff);
                params.setDrawableFlashOn(R.mipmap.ic_flash_on);
                params.setDrawableCameraSnapButton(R.drawable.demo_camera_button);

                //Customize UI elements in Crop/Preview screen            
                params.setCropperType(PiqALikeParams.CROPPER.FREEMODE);
                params.setRetakeBtnBGColor(Color.MAGENTA);
                params.setSearchBtnBGColor(Color.WHITE);
                
                //Customize UI elements in Filter screen
                params.setMainCategoryTextColor(Color.MAGENTA);
                params.setSubCategoryTextColor(Color.WHITE);
                
                //Cusotmize UI elements in Fetching dialog
                params.setFetchingDialogTitle("Searching...");
                params.setFetchingDialogTextColor(Color.MAGENTA);

                PiqALike.getInstance(Demo.this).initialize(VENDOR, TOKEN,params, new Callback() {
                    @Override
                    public void onSuccess(String response) {
                        PiqALike.getInstance(Demo.this).openCamera(new CameraCallback() {
                            @Override
                            public void onSuccess(String response, String originalBitmap, String croppedBitmap, String cropPoints,FilterApplied filterApplied) {
                                Log.v("callback","success");

}

                            @Override
                            public void onFail(String error) {
                                Log.v("callback","fail");
                            }
                        });
                    }

                    @Override
                    public void onFail(String error) {

                    }
                });

Launch your application and verify that the connection is successful. You are now ready to begin visual search.

To Start Visual Search

 PiqALike.getInstance(Context).openCamera(new CameraCallback() {
                    @Override
                    public void onSuccess(final String response, String originalBitmap, String croppedBitmap, String cropPoints){
                        // Handle Response

                    }

                    @Override
                    public void onFail(String error) {
                    // Handle Fail Case
                    }
                });

To find Visually similar products by productId

PiqALike.getInstance(Context).getVisuallySimilarProducts(PRODUCTID, new SimilarSearchResultsCallback() {
            @Override
            public void onSuccess(String response) {
                // Handle Response
            }

            @Override
            public void onFail(String error) {
              // Handle Fail Case
            }
        });

Note

Following Permissions are mandatory:

Manifest.permission.CAMERA // To use Device Camera
Manifest.permission.INTERNET // To connect Webservice and fetch matches
Manifest.permission.ACCESS_NETWORK_STATE // To check Network Availibility
Manifest.permission.READ_EXTERNAL_STORAGE or Manifest.permission.WRITE_EXTERNAL_STORAGE// To access Gallery to pick image for search matches

Contact

You can reach the Streamoid team at any time by emailing support@streamoid.com.