在付费墙中展示互动式体重目标图表
按照此方案,在付费墙流程中以数据图表形式展示每位用户的预计体重变化。用户在用户引导流程中输入当前体重和目标体重,你的应用收集这两个值。数据图表展示用户在你的应用帮助下每周可实现的进度,从初始值到目标值。你的应用将该数据图表作为原生视图渲染在自定义元素中,无需借助图表库即可绘制。
开始之前
创建两个独立的流程——一个用于用户引导,一个用于付费墙。将每个流程添加到对应的版位。本示例代码从 ID 为 weight_paywall 的版位获取付费墙流程。
1. 在用户引导流程中询问当前体重和目标体重
在流程与付费墙编辑工具中,向用户引导流程添加两个 Number 输入框:
- 一个用于输入当前体重(千克),Element ID 设为
weight。 - 一个用于输入目标体重(千克),Element ID 设为
goal_weight。
为确保您的应用在所有语言环境下以统一方式读取体重值,请在两个输入框的 Format 下拉菜单中选择 Integer。输入框会将用户输入的内容原样以文本形式发送给应用。本示例代码对 “70.5” 和 “70,5” 的处理方式不同,而整数没有小数分隔符。
为确保应用能接收到两个值,请在用户引导流程的末尾添加一个不包含任何输入框的屏幕。在该屏幕上添加一个按钮,并为其配置 Close flow 操作。输入框会在失去焦点或用户切换到另一个屏幕时发送其值。
2. 将自定义元素添加到付费墙页面
在付费墙流程中,向某个屏幕添加自定义元素,并为数据图表进行配置:
- Type:
line_chart。 - ID:
weight_goal。 - Height:保持默认的 Fixed 高度。图表将填满整个自定义元素。
请将自定义元素放在不响应触摸的容器之外(如轮播图),以确保只有图表响应拖动操作。
在自定义元素内部,添加一个包含示例体重图表的Image。当用户所使用的 app 版本无法显示图表时,该图片将作为备用内容展示。
3. 在应用中保存当前体重和目标体重
从用户引导流程的 flow_user_input 事件中获取当前体重和目标体重,具体方式参见处理流程数据。若要判断用户是否已到达最后一个屏幕,可监听 flow_screen_showed 事件中 is_last_screen 是否为 true。当用户引导流程在该屏幕关闭后,将两个体重值传入 showWeightPaywall——即打开带数据图表的付费墙流程的函数。
class WeightOnboardingListener(
private val activity: Activity, // the activity that displays the paywall flow
) : AdaptyFlowDefaultEventListener() {
private val enteredWeights = mutableMapOf<String, String>()
private var reachedLastScreen = false
override fun onAnalyticEvent(
name: String,
params: Map<String, Any?>,
context: Context,
) {
if (name == "flow_screen_showed" && params["is_last_screen"] == true) {
reachedLastScreen = true
return
}
if (name != "flow_user_input") return
val elementId = params["element_id"] as? String ?: return
val value = params["value"] as? String ?: return
enteredWeights[elementId] = value
}
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
// number inputs send their values as strings
val currentWeight = enteredWeights["weight"]?.toDoubleOrNull()
val goalWeight = enteredWeights["goal_weight"]?.toDoubleOrNull()
if (action == AdaptyUI.Action.Close && reachedLastScreen &&
currentWeight != null && goalWeight != null
) {
// on the last screen, open the paywall flow in place of the onboarding flow
showWeightPaywall(activity, currentWeight, goalWeight)
} else {
super.onActionPerformed(action, context) // the default handling, such as going back
}
}
}对于用户引导流程,在 AdaptyUI.getFlowView 的 eventListener 参数中传入 WeightOnboardingListener。创建监听器时,传入显示付费墙流程的 Activity。
在 Jetpack Compose 中,改为将监听器传递给 AdaptyFlowScreen,并在第二个 AdaptyFlowScreen 中显示付费墙流程。
public class WeightOnboardingListener extends AdaptyFlowDefaultEventListener {
private final Activity activity; // the activity that displays the paywall flow
private final Map<String, String> enteredWeights = new HashMap<>();
private boolean reachedLastScreen = false;
public WeightOnboardingListener(Activity activity) {
this.activity = activity;
}
@Override
public void onAnalyticEvent(String name, Map<String, ?> params, Context context) {
if (name.equals("flow_screen_showed") && Boolean.TRUE.equals(params.get("is_last_screen"))) {
reachedLastScreen = true;
return;
}
if (!name.equals("flow_user_input")) return;
Object elementId = params.get("element_id");
Object value = params.get("value");
if (elementId instanceof String && value instanceof String) {
enteredWeights.put((String) elementId, (String) value);
}
}
@Override
public void onActionPerformed(AdaptyUI.Action action, Context context) {
// number inputs send their values as strings
Double currentWeight = parseWeight(enteredWeights.get("weight"));
Double goalWeight = parseWeight(enteredWeights.get("goal_weight"));
if (action instanceof AdaptyUI.Action.Close && reachedLastScreen
&& currentWeight != null && goalWeight != null) {
// on the last screen, open the paywall flow in place of the onboarding flow
WeightPaywall.showWeightPaywall(activity, currentWeight, goalWeight);
} else {
super.onActionPerformed(action, context); // the default handling, such as going back
}
}
private static Double parseWeight(String value) {
if (value == null) return null;
try {
return Double.parseDouble(value);
} catch (NumberFormatException e) {
return null;
}
}
}对于用户引导流程,在 AdaptyUI.getFlowView 的 eventListener 参数中传入 WeightOnboardingListener。创建监听器时,传入显示付费墙流程的 Activity。
当用户在最后一个页面点击带有 关闭流程 操作 的按钮时,监听器会用付费墙流程替换用户引导流程。
4. 创建数据图表视图
创建体重计划的数据模型和包含数据图表的视图。该计划按周记录数据,从当前体重到目标体重。当用户在数据图表上拖动时,视图会标记触摸点对应的周次,并显示该周的预测体重:
class WeightPlan(currentWeight: Double, goalWeight: Double) {
// one entry per week, from the current weight to the goal weight
val entries: List<WeightEntry> = run {
val weeklyChange = 0.5 // kg per week
val start = System.currentTimeMillis()
val weekMillis = 7L * 24 * 60 * 60 * 1000
val weeks = ceil(abs(goalWeight - currentWeight) / weeklyChange).toInt()
val step = if (goalWeight < currentWeight) -weeklyChange else weeklyChange
(0..weeks).map { week ->
val kilograms = if (week == weeks) goalWeight else currentWeight + step * week
WeightEntry(Date(start + week * weekMillis), kilograms)
}
}
}
data class WeightEntry(val date: Date, val kilograms: Double)
@Composable
fun WeightGoalChart(entries: List<WeightEntry>) {
// the week under the finger, or null when the user isn't dragging
var selectedIndex by remember { mutableStateOf<Int?>(null) }
val textMeasurer = rememberTextMeasurer()
val dateFormat = remember { DateFormat.getDateInstance(DateFormat.MEDIUM) }
val color = Color(0xFFAF52DE)
val textStyle = TextStyle(color = Color.Gray, fontSize = 12.sp)
val minKg = entries.minOf { it.kilograms }
val kgRange = (entries.maxOf { it.kilograms } - minKg).coerceAtLeast(1.0)
Canvas(
Modifier
.fillMaxSize()
.pointerInput(entries) {
// horizontal drags select a week; vertical drags scroll the screen
detectHorizontalDragGestures(
onDragEnd = { selectedIndex = null },
onDragCancel = { selectedIndex = null },
) { change, _ ->
val index = (change.position.x / size.width * entries.lastIndex).roundToInt()
selectedIndex = index.coerceIn(0, entries.lastIndex)
}
}
) {
val startDate = textMeasurer.measure(dateFormat.format(entries.first().date), textStyle)
val endDate = textMeasurer.measure(dateFormat.format(entries.last().date), textStyle)
val dateY = size.height - startDate.size.height
val top = 24.dp.toPx() // room for the projected weight above the line
val bottom = dateY - 8.dp.toPx()
fun pointOf(index: Int) = Offset(
x = size.width * index / entries.lastIndex.coerceAtLeast(1),
y = bottom - ((entries[index].kilograms - minKg) / kgRange * (bottom - top)).toFloat(),
)
// the line from the current weight to the goal weight
for (index in 1..entries.lastIndex) {
drawLine(color, pointOf(index - 1), pointOf(index), strokeWidth = 2.dp.toPx())
}
// the dates of the first and the last week
drawText(startDate, topLeft = Offset(0f, dateY))
drawText(endDate, topLeft = Offset(size.width - endDate.size.width, dateY))
// the selected week: a point, and the projected weight above it
selectedIndex?.let { index ->
val point = pointOf(index)
drawCircle(color, radius = 5.dp.toPx(), center = point)
val weight = String.format(Locale.getDefault(), "%.1f kg", entries[index].kilograms)
val label = textMeasurer.measure(weight, textStyle.copy(color = color))
val x = (point.x - label.size.width / 2)
.coerceAtMost(size.width - label.size.width)
.coerceAtLeast(0f)
drawText(label, topLeft = Offset(x, point.y - label.size.height - 8.dp.toPx()))
}
}
}
public class WeightPlan {
// one entry per week, from the current weight to the goal weight
public final List<WeightEntry> entries = new ArrayList<>();
public WeightPlan(double currentWeight, double goalWeight) {
double weeklyChange = 0.5; // kg per week
long start = System.currentTimeMillis();
long weekMillis = 7L * 24 * 60 * 60 * 1000;
int weeks = (int) Math.ceil(Math.abs(goalWeight - currentWeight) / weeklyChange);
double step = goalWeight < currentWeight ? -weeklyChange : weeklyChange;
for (int week = 0; week <= weeks; week++) {
double kilograms = week == weeks ? goalWeight : currentWeight + step * week;
entries.add(new WeightEntry(new Date(start + week * weekMillis), kilograms));
}
}
}
public class WeightEntry {
public final Date date;
public final double kilograms;
public WeightEntry(Date date, double kilograms) {
this.date = date;
this.kilograms = kilograms;
}
}
public class WeightGoalChartView extends View {
private final List<WeightEntry> entries;
private final DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.MEDIUM);
private final Paint chartPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
private final Paint datePaint = new Paint(Paint.ANTI_ALIAS_FLAG);
private final float density = getResources().getDisplayMetrics().density;
private final int touchSlop;
private double minKg = Double.MAX_VALUE;
private double maxKg = -Double.MAX_VALUE;
private float downX;
private float downY;
// the week under the finger, or -1 when the user isn't dragging
private int selectedIndex = -1;
public WeightGoalChartView(Context context, List<WeightEntry> entries) {
super(context);
this.entries = entries;
touchSlop = ViewConfiguration.get(context).getScaledTouchSlop();
float textSize = TypedValue.applyDimension(
TypedValue.COMPLEX_UNIT_SP, 12, getResources().getDisplayMetrics());
chartPaint.setColor(0xFFAF52DE);
chartPaint.setStrokeWidth(2 * density);
chartPaint.setTextSize(textSize);
datePaint.setColor(Color.GRAY);
datePaint.setTextSize(textSize);
for (WeightEntry entry : entries) {
minKg = Math.min(minKg, entry.kilograms);
maxKg = Math.max(maxKg, entry.kilograms);
}
}
@Override
protected void onDraw(Canvas canvas) {
// the line from the current weight to the goal weight
for (int index = 1; index < entries.size(); index++) {
canvas.drawLine(xOf(index - 1), yOf(index - 1), xOf(index), yOf(index), chartPaint);
}
// the dates of the first and the last week
String endDate = dateFormat.format(entries.get(entries.size() - 1).date);
float dateY = getHeight() - datePaint.descent();
canvas.drawText(dateFormat.format(entries.get(0).date), 0, dateY, datePaint);
canvas.drawText(endDate, getWidth() - datePaint.measureText(endDate), dateY, datePaint);
// the selected week: a point, and the projected weight above it
if (selectedIndex >= 0) {
float x = xOf(selectedIndex);
float y = yOf(selectedIndex);
canvas.drawCircle(x, y, 5 * density, chartPaint);
double kilograms = entries.get(selectedIndex).kilograms;
String weight = String.format(Locale.getDefault(), "%.1f kg", kilograms);
float width = chartPaint.measureText(weight);
float labelX = Math.max(0, Math.min(x - width / 2, getWidth() - width));
canvas.drawText(weight, labelX, y - 8 * density, chartPaint);
}
}
@Override
public boolean onTouchEvent(MotionEvent event) {
switch (event.getActionMasked()) {
case MotionEvent.ACTION_DOWN:
downX = event.getX();
downY = event.getY();
return true;
case MotionEvent.ACTION_MOVE:
// horizontal drags select a week; vertical drags scroll the screen
float dx = Math.abs(event.getX() - downX);
if (selectedIndex < 0 && (dx < touchSlop || dx < Math.abs(event.getY() - downY))) {
return true;
}
getParent().requestDisallowInterceptTouchEvent(true);
int index = Math.round(event.getX() / getWidth() * (entries.size() - 1));
selectedIndex = Math.max(0, Math.min(index, entries.size() - 1));
invalidate();
return true;
case MotionEvent.ACTION_UP:
case MotionEvent.ACTION_CANCEL:
selectedIndex = -1;
invalidate();
return true;
}
return super.onTouchEvent(event);
}
private float xOf(int index) {
return getWidth() * index / (float) Math.max(entries.size() - 1, 1);
}
private float yOf(int index) {
float top = 24 * density; // room for the projected weight above the line
float bottom = getHeight() - datePaint.getFontSpacing() - 8 * density; // room for the dates
double fraction = (entries.get(index).kilograms - minKg) / Math.max(maxKg - minKg, 1);
return (float) (bottom - fraction * (bottom - top));
}
} 该方案假设每周体重变化为 0.5 kg。如需使用其他变化速率,请修改 weeklyChange。
5. 将数据图表与自定义元素关联
编写一个解析器,使其为 line_chart 类型和 weight_goal ID 返回图表视图。将体重计划存储在解析器的属性中:
class WeightChartResolver(
private val plan: WeightPlan,
) : AdaptyCustomElementsResolver {
override fun resolve(type: String, id: String): AdaptyCustomElementContent? =
if (type == "line_chart" && id == "weight_goal") {
AdaptyCustomElementContent.compose { WeightGoalChart(plan.entries) }
} else {
null // another custom element: show the fallback
}
}
public class WeightChartResolver implements AdaptyCustomElementsResolver {
private final WeightPlan plan;
public WeightChartResolver(WeightPlan plan) {
this.plan = plan;
}
@Override
public AdaptyCustomElementContent resolve(String type, String id) {
if (type.equals("line_chart") && id.equals("weight_goal")) {
return AdaptyCustomElementContent.view(
(context, elementContext) -> new WeightGoalChartView(context, plan.entries)
);
}
return null; // another custom element: show the fallback
}
} 创建付费墙流程视图时,附加解析器。使用当前体重和目标体重的减重计划创建解析器:
fun showWeightPaywall(activity: Activity, currentWeight: Double, goalWeight: Double) {
val plan = WeightPlan(currentWeight, goalWeight)
Adapty.getFlow("weight_paywall") { flowResult ->
if (flowResult !is AdaptyResult.Success) return@getFlow // handle the error
AdaptyUI.getFlowConfiguration(flowResult.value) { configResult ->
if (configResult !is AdaptyResult.Success) return@getFlowConfiguration // handle the error
val flowView = AdaptyUI.getFlowView(
activity,
configResult.value,
products = null,
eventListener = AdaptyFlowDefaultEventListener(),
customElementsResolver = WeightChartResolver(plan),
)
activity.setContentView(flowView) // in place of the onboarding flow
}
}
}
public class WeightPaywall {
public static void showWeightPaywall(Activity activity, double currentWeight, double goalWeight) {
WeightPlan plan = new WeightPlan(currentWeight, goalWeight);
Adapty.getFlow("weight_paywall", flowResult -> {
if (!(flowResult instanceof AdaptyResult.Success)) return; // handle the error
AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) flowResult).getValue();
AdaptyUI.getFlowConfiguration(flow, configResult -> {
if (!(configResult instanceof AdaptyResult.Success)) return; // handle the error
AdaptyFlowView flowView = AdaptyUI.getFlowView(
activity,
((AdaptyResult.Success<AdaptyUI.FlowConfiguration>) configResult).getValue(),
null, // products
new AdaptyFlowDefaultEventListener(),
// defaults: if your app passes other values here, keep them
AdaptyFlowInsets.Unspecified,
AdaptyCustomAssets.Empty,
AdaptyUiTagResolver.Default,
AdaptyUiTimerResolver.Default,
null, // observerModeHandler
new WeightChartResolver(plan)
);
activity.setContentView(flowView); // in place of the onboarding flow
});
});
}
} 如果你的应用设置了全局解析器,该解析器会在付费墙流程中被此解析器替换。WeightChartResolver 对其他任何 Type 和 ID 均不返回视图,因为此示例中的付费墙流程没有其他自定义元素。如果你的付费墙流程包含其他自定义元素,请将全局解析器传入此解析器,然后针对对应的 Type 和 ID 调用全局解析器,具体方式参见为单个流程显示数据。
6. 在设备上测试
流程与付费墙编辑工具无法运行你的应用代码,因此其画布只显示备用内容。要预览数据图表:
- 发布两个流程。若要查看最新发布版本而非缓存版本,请将设备注册为测试设备。
- 运行包含解析器的应用构建版本。完成用户引导流程,输入当前体重和目标体重。验证数据图表的折线是否从当前体重开始,到目标体重结束。
- 在数据图表上拖动,验证手指所在周的预估体重是否显示在折线上方。
如需测试备用付费墙,请让 WeightChartResolver 返回 null,然后重新打开付费墙流程。
要了解为什么出现备用付费墙而非数据图表,请按照 Android 指南中在设备上测试部分的说明操作。