통합 가이드

Preparing the Environment
Supports Flutter 3.16.0 or later.
Android development:
Android Studio 3.5 or later.
Android SDK API Level 19 or higher.
Android 4.4 or higher, supports mobile devices with armeabi-v7a and arm-v8a architecture.
iOS development:
Xcode 11.0 or later.
iPhone or iPad with iOS 9.0 or later.
The project has a configured valid developer signature.
SDK Download
The address of the Tencent Gift AR Flutter project is EffectPlayer Flutter.
Quick Integration
Adding Dependencies in pubspec.yaml
Integration via pub method
Add the following configuration in pubspec.yaml:
# It is optional by default. If conflicts arise with the BeautyAR SDK, you may include it and specify NoXMagic
EffectPlayer:
  sub_spec: 'Default'
# You can switch between the following versions based on your requirements (supported from version 3.4.1):
# Default: The default option integrates the complete SDK package, including the TCXMagicAuth library.
# NoXMagic: This option excludes the TCXMagicAuth library during SDK integration, typically used when the project already contains a BeautyAR SDK to resolve class conflicts.
﻿
﻿
﻿
flutter_effect_player: ^3.4.1
Integration via Remote Repository
To integrate the latest version of EffectPlayer_Player (which is the default version), add the following configuration to your `pubspec.yaml` file:
# It is optional by default. If conflicts arise with the BeautyAR SDK, you may include it and specify NoXMagic
EffectPlayer:
  sub_spec: 'Default'
# You can switch between the following versions based on your requirements (supported from version 3.4.1):
# Default: The default option integrates the complete SDK package, including the TCXMagicAuth library.
# NoXMagic: This option excludes the TCXMagicAuth library during SDK integration, typically used when the project already contains a BeautyAR SDK to resolve class conflicts.
﻿
﻿
  
flutter_effect_player:
  git:
    url: https://github.com/Tencent-RTC/EffectPlayer_Flutter.git
If necessary, you can specify the tag of the ref dependency to use the specified version, as shown below:
flutter_effect_player:
  git:
    url: https://github.com/Tencent-RTC/EffectPlayer_Flutter
    ref: release_example_tag
For more archived tags, see release list.
After integration, you can get the Flutter dependency through the built-in UI of the code editor or directly use the following commands:
flutter pub get
During use, the following command can be used to update the existing Flutter dependency:
flutter pub upgrade
Adding Native End Configuration
Android End Configuration
Encrypting Video Playback Configuration
If you check the Anim Encrypt option when converting animations using TepTools, the output animation will be encrypted. At this point, during playback with the effect player, if your application's targetSDKVersion is at least 28, configure as follows separately:
1. Create an xml file at res/xml/network_security_config.xml and set the network security configuration:
  <?xml version="1.0" encoding="utf-8"?>
 <network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">localhost</domain>
        <domain includeSubdomains="true">127.0.0.1</domain>
    </domain-config>
 </network-security-config>
2. Add the following properties to the application tag in the AndroidManifest.xml file:
  <?xml version="1.0" encoding="utf-8"?>
 <manifest ... >
    <application android:networkSecurityConfig="@xml/network_security_config"
                   ... >
     ...
    </application>
</manifest>
iOS End Configuration
Note:
Note: iOS currently does not support simulator operation and debugging. It is advisable to perform development and debugging on a real device.
Encrypting Video Playback Configuration
If you check the Anim Encrypt option when converting animations using TepTools, the output animation will be encrypted. At this point, during playback with the effect player, configure as follows separately by adding the following configuration to iOS's Info.plist:
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>