tencent cloud

source 'https://e.coding.net/tcmpp-work/tcmpp/tcmpp-repo.git'

pod install

class MyAppletHandler extends OpenApiHandler {
  @override
  Future<Map<String, dynamic>> getUserProfile(
      AppInfo appInfo, Map<Object?, Object?> params) async {
    print("getUserProfile:$appInfo params:$params");
    Map<String, dynamic> result = {
      "userInfo": {
        "nickName": "xcode",
        "avatarUrl":
            "https://staticintl.cloudcachetci.com/cms/backend-cms/8WGP653_%E5%BC%80%E5%8F%91%E8%80%85%E5%B7%A5%E5%85%B7%E9%80%9A%E7%94%A8.png",
        "gender": 1,
        "country": "China",
        "province": "ChongQing",
        "city": "ChongQing",
      }
    };
    return result;
  }

  @override
  Future<Map<String, dynamic>> login(
     AppInfo appInfo, Map<Object?, Object?> params) async {
    /// return current login certification or do login if not logged in
    ...
  }

  @override
  Future<Map<String, dynamic>> checkSession(
     AppInfo appInfo, Map<Object?, Object?> params) async {
     /// throw any error if this api call is failed
     throw NotLoggedInError();
  }

  /// other api implementation
  ...
}

final _tcmppFlutterPlugin = TcmppFlutter();

...

@override
void initState() {
   super.initState();

   ...

   /// Must registered before mini-program is launched
   _tcmppFlutterPlugin.registerOpenApiHandler(MyAppletHandler());
}

example code:
   /// Mini Program Call
 var opts = {
 api_name: 'myApiName',
 success: function(res) {
   log(res);
 },
 fail: function(res) {
   log(res);
 },
 complete: function(res) {
   log(res);
 },
 data: { 
     name : 'kka',
     age : 22
  }
 }
 wx.invokeNativePlugin(opts); 

void initState() {
    super.initState();
    getRecentMini();
    /// Register custom JSAPI names and functions
    _tcmppFlutterPlugin.registerMiniAppApi("myApiName",myApiHandler);
}


/// Custom API
Future<Map<String, dynamic>?> myApiHandler(MiniApiCall call) async {
    print("API : ${call.apiName}");
    print("AppInfo: ${call.appInfo}");
    print("WebView ID: ${call.webViewId}");
    print("params: ${call.params}");


    return {"result": "success","method":"myApiHandler"};
}

class MyPlatformHandler extends TcmppPlatformEventHandler {
  @override
  Future<void> onMiniProgramStateChange(
      String appId, MiniProgramState state) async {
    print("app state change: appid=$appId, state=$state");
  }


  /// other event handler implementation
  ...
}

final _tcmppFlutterPlugin = TcmppFlutter();

...

@override
void initState() {
   super.initState();
   
   ...

   /// Must registered before mini-program is launched
  _tcmppFlutterPlugin.registerPlatformEventHandler(MyPlatformHandler());
}

@override
Future<List<CustomMenu>> getCustomMenus() async {
/// The menu includes menuId, picture (supports local path and network picture), menu name, and whether it is a custom sharing type.
  CustomMenu menu1 = CustomMenu(
      '100', 'res/images/mini_app_wechat_friend.png', 'Share To', true,
      shareKey: 'twitter');
  CustomMenu menu2 = CustomMenu(
      '101', 'https://staticintl.cloudcachetci.com/cms/backend-cms/8WGP653_%E5%BC%80%E5%8F%91%E8%80%85%E5%B7%A5%E5%85%B7%E9%80%9A%E7%94%A8.png', 'Custom', false);


  return [
    menu1,
    menu2,
  ];
}

@override
Future<void> customMenuClick(String menuId, ShareData? shareMenu) async {
  /// callback for menu button click
  print("click menuId:$menuId shareMenu:$shareMenu");
  throw UnimplementedError();
}

@override
Future<void> onMiniProgramStateChange(
    String appId, MiniProgramState state) async {
  print("app state change: appid=$appId, state=$state");
}

@override
Future<void> log(String message) async {
  print(message);
}

@override
Future<bool> reportEvent(int eventId, String eventName, AppInfo appInfo,
    Map<Object?, Object?> params) async {
  print("reportEvent:$eventName  appinfo:$appInfo params:$params");
  // TODO: implement reportEvent
  return Future.value(false);
}

Future<void> startMiniAppWithId(String appId, MiniStartOptions? options)

Future<void> startMiniAppWithLink(String link, MiniStartOptions? options)

Future<ScanResult?> scan()

Future<List<AppInfo>?> getRecentList()

Future<List<AppInfo>?> searchMiniApp(String keyword,
   {int pageIndex = 0, int pageSize = 0})

Future<void> stopMiniApp(String appId)

Future<void> stopAllMiniApp()

Future<void> deleteMiniAppCache(String appId,
   {int appVerType = 0, String? ver

Future<AppInfo?> currentMiniApp()

Future<void> preDownloadMiniApp(List<String> appIdList,
   {bool isDownload = false})

void registerOpenApiHandler(OpenApiHandler handler)

void registerPlatformEventHandler(TcmppPlatformEventHandler handler)

void registerMiniAppApi(String apiName, TcmppMiniAppApiHandler apiHandler)

void setAccount(AccountInfo? info)

Future<void> setLocale(String language,
      {String? region, String? variant})

Future<void> setTheme(MiniTheme theme)

class MiniStartOptions {
  /// entry path of mini program
  String? entryPath;

  /// is always update mini program when start
  bool? isForceUpdate;

  /// string param passed to mini program when start
  String? params;
}

class ScanResult {
  /// result string of qrcode or barcode contains
  String? result;

  /// the type of code
  String? scanType;

  /// charset of result string
  String? charset;
}

class AppInfo {
  /// MiniProgram id
  String appId;

  /// MiniProgram package type (release, dev, etc.). See [AppVerType]
  int appVerType;

  /// MiniProgram version
  String version;

  /// MiniProgram name
  String? name;

  /// MiniProgram icon url
  String? iconUrl;

  /// MiniProgram description
  String? appIntro;

  /// Developer of MiniProgram
  String? appDeveloper;

  /// MiniProgram release time
  int time;
}

/// Consts for MiniProgram package type. see[AppInfo]
class AppVerType {
  static const int online = 0;
  static const int develop = 1;
  static const int preview = 2;
  static const int experience = 3;
}

class AccountInfo {
  /// Unique id of current account
  String? uid;


  /// Url of avatar image
  String? avatarUrl;


  /// Name of current account
  String? accountName;
}

abstract class OpenApiHandler {
  /// Called when mini-program invoke wx.requestPayment, requesting third-party payment action
  ///  
  Future<Map<String, dynamic>> requestPayment(
      AppInfo appInfo, Map<Object?, Object?> params);

  /// Called when mini-program invoke wx.getUserProfile, requesting host app's user information
  ///
  Future<Map<String, dynamic>> getUserProfile(
      AppInfo appInfo, Map<Object?, Object?> params);

  /// Called when mini-program invoke wx.login, requesting host app's login certificate
  ///
  Future<Map<String, dynamic>> login(
      AppInfo appInfo, Map<Object?, Object?> params);

  /// Called when mini-program invoke wx.checkSession, requesting host app's login state
  /// check if login expired
  ///
  Future<Map<String, dynamic>> checkSession(
      AppInfo appInfo, Map<Object?, Object?> params);

  /// Called when mini-program invoke wx.getUserInfo, deprecated by wx.getUserProfile
  /// compatibility for earlier mini-program api
  ///
  Future<Map<String, dynamic>> getUserInfo(
      AppInfo appInfo, Map<Object?, Object?> params);

  /// Called when mini-program invoke wx.getPhoneNumber, get current user's phone number
  ///
  Future<Map<String, dynamic>> getPhoneNumber(
      AppInfo appInfo, Map<Object?, Object?> params);
}

abstract class TcmppPlatformEventHandler {


  Future<String> getAppName() async {
    return "";
  }


  Future<String> getAppVersion() async {
    return "";
  }


  Future<void> log(String message) async {}


  Future<List<CustomMenu>> getCustomMenus() async {
    return [];
  }


  Future<void> customMenuClick(String menuId, ShareData? shareMenu) async {}
  
  Future<void> onMiniProgramStateChange(
      String appId, MiniProgramState state) async {}


  Future<bool> reportEvent(int eventId, String eventName, AppInfo appInfo,
      Map<Object?, Object?> params) async {
    return false;
  }
}