Flutter游戏互动插件gameball的使用

Gameball的Flutter SDK允许你在应用中展示玩家个人资料、跟踪玩家事件、集成推荐系统并显示Gameball的内置推送通知。

功能

Gameball的Flutter SDK允许你在应用中展示玩家个人资料、跟踪玩家事件、集成推荐系统并显示Gameball的内置推送通知。

开始使用

以下是开始在你的应用中安装Gameball Flutter SDK的步骤：

使用方法

以下是一些简短且有用的示例代码供用户参考。更长的示例代码可以在/example文件夹中找到。

const like = 'sample';

额外信息

更多详细信息请访问：Gameball开发者文档

示例代码

示例代码：example/lib/main.dart

import 'dart:convert';

import 'package:flutter/material.dart';
import 'package:gameball/gameball.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Gameball SDK',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Gameball SDK Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {

  // 仅用于测试
  TextEditingController textFieldController1 = TextEditingController();
  TextEditingController textFieldController2 = TextEditingController();
  TextEditingController textFieldController3 = TextEditingController();
  TextEditingController textFieldController4 = TextEditingController();
  TextEditingController textFieldController5 = TextEditingController();
  TextEditingController textFieldController6 = TextEditingController();

  String dropdownValue = 'en';
  bool isButtonEnabled = true;
  String? apiKey;
  String? playerUniqueId;
  String? lang;

  [@override](/user/override)
  void initState() {
    super.initState();
    textFieldController1.text = 'df07d27a8f6f440e8a7f44195fc6c5e6'; // 示例API密钥
    textFieldController2.text = 'MartinSorsok'; // 示例玩家唯一ID
    textFieldController3.text = '''
{
  "place_order": {
    "total_amount": "100",
    "category": [
      "electronics",
      "cosmetics"
    ]
  },
  "review": {}
}'''; // 示例事件数据

    textFieldController4.text = '''
{
  "playerUniqueId": "${textFieldController2.text}",
  "mobile": "+1234567",
  "email": "jon.snow@example.com",
  "playerAttributes": {
    "displayName": "Jon Snow"
  },
  "referrerCode": null,
  "levelOrder": null
}'''; // 示例玩家数据

    textFieldController5.text = ''; // 平台字段
    textFieldController6.text = ''; // 商店字段
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: SingleChildScrollView(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Padding(
                padding: const EdgeInsets.only(left: 20.0, right: 20),
                child: TextField(
                  controller: textFieldController1,
                  onChanged: (value) => checkInputs(),
                  decoration: InputDecoration(
                    labelText: 'API Key',
                  ),
                ),
              ),
              Padding(
                padding: const EdgeInsets.only(left: 20.0, right: 20),
                child: TextField(
                  controller: textFieldController2,
                  onChanged: (value) => checkInputs(),
                  decoration: InputDecoration(
                    labelText: 'Player Unique ID',
                  ),
                ),
              ),
              Padding(
                padding: const EdgeInsets.only(left: 20.0, right: 20),
                child: TextField(
                  controller: textFieldController5,
                  onChanged: (value) => checkInputs(),
                  decoration: InputDecoration(
                    labelText: 'Platform',
                  ),
                ),
              ),
              Padding(
                padding: const EdgeInsets.only(left: 20.0, right: 20),
                child: TextField(
                  controller: textFieldController6,
                  onChanged: (value) => checkInputs(),
                  decoration: InputDecoration(
                    labelText: 'Shop',
                  ),
                ),
              ),
              Row(
                mainAxisAlignment: MainAxisAlignment.spaceEvenly,
                children: [
                  Text('Language'),
                  DropdownButton<String>(
                    value: dropdownValue,
                    onChanged: (String? newValue) {
                      setState(() {
                        dropdownValue = newValue!;
                      });
                    },
                    items: ['en', 'ar']
                        .map<DropdownMenuItem<String>>((String value) {
                      return DropdownMenuItem<String>(
                        value: value,
                        child: Text(value),
                      );
                    }).toList(),
                  ),
                ],
              ),
              ElevatedButton(
                onPressed: isButtonEnabled
                    ? () {
                  apiKey = textFieldController1.text;
                  playerUniqueId = textFieldController2.text;
                  lang = dropdownValue;
                  final String playerDataString = textFieldController4.text;

                  final Map<String, dynamic> playerData =
                      jsonDecode(playerDataString);
                  Gameball gameball = Gameball(
                    apiKey: apiKey != null ? apiKey! : '',
                    playerUniqueId: playerUniqueId!,
                    lang: lang,
                    playerAttributes: playerData,
                    platform: textFieldController5.text,
                    shop: textFieldController6.text,
                  );
                  gameball.openGameballView(context);
                }
                    : null,
                child: Text('打开GameBall'),
              ),
              Padding(
                padding: const EdgeInsets.only(left: 20.0, right: 20),
                child: Container(
                  height: 300, // 调整高度
                  child: TextField(
                    controller: textFieldController3,
                    decoration: InputDecoration(
                      labelText: '事件数据',
                    ),
                    maxLines: null, // 允许多行输入
                  ),
                ),
              ),
              ElevatedButton(
                onPressed: () {
                  sendEvent("metaData");
                },
                child: Text('发送GameBall事件'),
              ),
              Padding(
                padding: const EdgeInsets.only(left: 20.0, right: 20),
                child: Container(
                  height: 300, // 调整高度
                  child: TextField(
                    controller: textFieldController4,
                    decoration: InputDecoration(
                      labelText: '玩家数据',
                    ),
                    maxLines: null, // 允许多行输入
                  ),
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }

  void checkInputs() {
    setState(() {
      isButtonEnabled = true;
      // isButtonEnabled = textFieldController1.text.isNotEmpty &&
      //     textFieldController2.text.isNotEmpty;
    });
  }

  void sendEvent(metaData) {
    Gameball gameball = Gameball(
      apiKey: textFieldController1.text,
      playerUniqueId: textFieldController2.text,
      lang: lang,
    );
    final String eventDataString = textFieldController3.text;

    final Map<String, dynamic> eventData = jsonDecode(eventDataString);
    gameball.sendEvent(eventData).then((response) {
      print(response); // 成功
    }).catchError((error) {
      print(error); // 错误
    });
  }
}