字节跳动内容合作 Flutter版本 #

简介 #

flutter_pangrowth是一个可以帮助开发者直接引入穿山甲内容合作的插件。体验demo 目前仅支持小说。

说明 #

使用flutter_pangrowth插件，必须先接入穿山甲广告插件flutter_unionad,不然无法显示广告

接入文档 #

• Android

• ios

本地环境 #

[✓] Flutter (Channel stable, 2.8.0, on macOS 12.0.1 21A559 darwin-x64, locale zh-Hans-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 30.0.3)
[✓] Xcode - develop for iOS and macOS (Xcode 13.1)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2020.3)
[✓] VS Code (version 1.63.0)
[✓] Connected device (4 available)

集成步骤 #

1、pubspec.yaml

flutter_pangrowth: ^0.0.2

2、引入

import 'package:flutter_pangrowth/flutter_pangrowth.dart';

使用 #

1、SDK初始化

⚠️注意 ：初始化sdk前，必须先调用用flutter_unionad的初始化方法，不然无法加载广告

await FlutterPangrowth.registerNovel(
      //接入小说SDK的App的英文名 必填
      appName: "appName",
      ////接入小说SDKApp的版本名称 必填
      appVersionName: "1.0.0",
      //接入小说SDK App的版本号 必填
      appVersionCode: 1,
      //埋点上传时的渠道号维度。开发者自定义字符串即可(建议不要包含test)。选填
      channel: "test",
      ////appid 必填
      andoridAppId: "302043",
      iosAppId: "299886",
      //是否显示日志
      debug: true,
        //是否个性化推送广告
        personalRecommendAd: true,
        //是否个性化推送小说内容
        personalRecommendContent: true,
        //全局字号大小
        normalFontType: NormalFontSize.normal,
        //阅读字号大小
        readFontType: ReadFontSize.two,
    );

2、打开小说主页

await FlutterPangrowth.openNovelPage();

3、NovelEntity说明

{
    "code": true,//true获取成功 false获取失败
    "msg": "",//错误提示
    "data": [//返回小说数组
        {
            "bookId": "6806002909138914318",//小说id
            "bookName": "",//小说名字
            "readUrl": "",//阅读地址
            "thumbUrl": "",//小说封面
            "novelDetail": ""//小说具体信息json（由于android、ios数据格式、后续跳转所需参数等都不相同，所以不做处理直接返回json数据，开发者可根据需求在项目中自行解析）
        }
    ]
}

4、获取阅读历史

NovelEntity novel = await FlutterPangrowth.getNovelHistory();

5、获取启动推荐书籍列表

NovelEntity novel = await FlutterPangrowth.getNovelRecommendV1(
          size: 10,//返回数据数量
        )

6、获取Feed推荐书籍列表

NovelEntity novel = await FlutterPangrowth.getNovelRecommendFeed(
          size: 10,//返回数据数量
        )

7、小说显示上报

await FlutterPangrowth.reportRecentNovelShow(
         type: result.type,//NovelEntity 中type字段
         book: result.novelDetail,//NovelEntity 中novelDetail字段
);

8、打开小说页面

await FlutterPangrowth.openNovelPageWithConfig(
  type: result.type,//NovelEntity 中type字段
  book: result.novelDetail,//NovelEntity 中novelDetail字段
);

9、获取当日阅读时长

单位：毫秒

int _duration = await FlutterPangrowth.getReadDuration();

10、获取搜索Suggestion

NovelEntity novel = await FlutterPangrowth.searchNovelSuggestions(
          queryContent: query,//搜索关键字
          offset: 1,//页码
          limit: 20,//单次数量
)

11、获取搜索Results

NovelEntity novel = await FlutterPangrowth.searchNovelResults(
          queryContent: query,//搜索关键字
          offset: 1,//页码
          limit: 20,//单次数量
)

12、根据url跳转小说页面

await FlutterPangrowth.openNovelPageWithUrl(url: result.readUrl,//NovelEntity中readUrl
  );

14、小说导流入口控件

FlutterPangrowth.novelEntranceView(
                viewWidth: 50,//宽
                viewHeight: 50,//高
                type: FlutterNovelEntranceType.icon,//类型
                style: FlutterNovelIconSytle.circle,//类型下对应样式
              ),

///小说导流控件类型
class FlutterNovelEntranceType{
  ///金刚位
  static const String icon = "icon";
  ///FloatBall悬浮球
  static const String floatBall = "floatBall";
  ///Banner
  static const String banner = "banner";
  ///Window
  static const String window = "window";
  ///Feed流小图
  static const String feedSingle = "feedSingle";
  ///Feed流列表
  static const String feedList = "feedList";
}

插件链接 #

联系方式 #

• Email: [email protected]

• Blog：https://gstory.vercel.app/

• QQ群: