futuriza_flutter 0.1.3

SDK para integração com os serviços Futuriza

Futuriza Flutter

SDK para integração com os serviços Futuriza.
Permite a adição de modelos 3D de produtos ao seu aplicativo, para que o seu usuário tenha uma melhor noção de como o produto é e faça uma compra mais assertiva.
É possível adicionar o modelo do produto dentro de uma tela, ou visualizá-lo em um ambiente real através de realidade aumentada.

Instalação

Adicione a biblioteca como dependência do seu projeto no pubspec.yaml:

dependencies:
    futuriza_flutter: ^0.0.1

Permissões

Para mostrar os produtos em um ambiente real usando realidade aumentada, será necessário utilizar a câmera do usuário. Para isso, é preciso adicionar as permissões de acesso à câmera no seu aplicativo.

Android

Configure seu projeto para utilizar o AndroidX.

1. Adicione as seguintes linhas ao seu gradle.properties:

android.useAndroidX=true
android.enableJetifier=true

2. Altere o compileSdkVersion de android/app/build.gradle para 33:

android {
    compileSdkVersion 33
}

Adicione o uso da permissão android.permission.CAMERA ao AndroidManifest.xml:

<uses-permission android:name="android.permission.CAMERA"/>

Adicione a configuração android:usesCleartextTraffic="true" ao AndroidManifest.xml:

<application 
  android:usesCleartextTraffic="true"
  ...>

iOS

Adicione PERMISSION_CAMERA=1 ao Podfile, indicando que o seu aplicativo utiliza a permissão de câmera:

post_install do |installer|
    installer.pods_project.targets.each do |target|
      flutter_additional_ios_build_settings(target)
      target.build_configurations.each do |config|
        config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
          '$(inherited)',
          ## dart: PermissionGroup.camera
          'PERMISSION_CAMERA=1',
        ]
      end
    end
  end

Adicione a mensagem de permissão NSCameraUsageDescription ao Info.plist:

    <key>NSCameraUsageDescription</key>
    <string>Precisamos acessar a sua câmera para te mostrar um produto incrível!</string>

Adicione a configuração io.flutter.embedded_views_preview ao Info.plist:

  <key>io.flutter.embedded_views_preview</key>
  <true/>

Modo de usar

FuturizaService

Essa classe pode ser utilizada para consumir os dados da API Futuriza.
O método principal é o getProduct3DModel, que retorna as informações do modelo 3D do produto, informando se ele possui modelo 3D, se possui experimentação, e as URLs para visualização.

const futurizaService = FuturizaService();

// Obtém os dados do modelo 3D do produto
final modelInfo = await futurizaService.getProduct3DModel(
    productId: myProductId,
    token: myClientToken,
);

// Caso o produto possua modelo 3D, você pode mostrá-lo
if (productModel.has3D) {
  _show3DModel = true;
}

// Caso o produto possua experimentação, você pode mostrá-la
if (productModel.hasTryOn) {
  _showTryOn = true;
}

Product3DModelRenderer

Utilize esse Widget para adicionar o modelo 3D de um produto como seção de uma tela existente.
É necessário informar os dados do modelo 3D do produto.

Product3DModelRenderer(
    productModel: productModel,
);

ARTryOn

Utilize esse Widget para mostrar o modelo 3D de um produto em realidade aumentada, permitindo que o usuário o veja em um ambiente real ou prove-o.
É necessário informar os dados do modelo 3D do produto.
Você pode usar esse Widget para adicionar a visualização como seção de uma tela existente, ou usar o método showARTryOn para abrir uma página de visualização.

ARTryOn(
  productModel: productModel,
);

showARTryOn(
    context,
    productModel,
);