OpenAPI内容参数说明

从您提供的信息来看，这是关于阿里云推送服务（例如：Push Service）中Android和iOS平台消息与通知内容参数设置的详细说明。我将基于这些信息帮助您理解如何在不同场景下配置消息或通知的内容。

Android平台

• 消息（Message）:

  • title: 消息标题，通过PushMessageToAndroidMessage接口时，此字段为必填，且长度限制为前19个字符。
  • body: 消息内容，同样是必填项。

• 通知（Notification）:

  • title: 通知标题，使用PushNoticeToAndroidTitle接口时，需要填写，并且提供一个摘要（Summary），两者都是必填项。
  • body: 通知内容，这里使用的是摘要（Summary）。

iOS平台

• 消息（Message）:

  • title: 当直接推送消息时，如果提供了Summary，则标题取其前19个字符；若未提供，则取消息内容（Message）的前19个字符。
  • body: 如果设置了Summary并且设备不在线，当消息转为通知时，内容使用Summary；否则，消息内容即为Message。

• 通知（Notification）:

  • 在OpenAPI 1.0中，body通常采用Summary，如果Summary为空，则使用Title作为内容。
  • OpenAPI 2.0简化了配置，直接指定title和body，对于iOS通知，body可以直接设定，如果有特殊需求如消息转通知、小米托管弹窗等，可以额外设置iOSRemindBody、XiaoMiNotifyTitle、XiaoMiNotifyBody等字段。

参数总结

• OpenAPI 1.0更注重于区分消息与通知的不同处理逻辑，尤其是在iOS平台上，根据是否设置Summary以及设备状态来决定内容展示方式。
• OpenAPI 2.0倾向于提供更加统一和简洁的接口调用方式，减少了条件判断，直接通过title和body设置内容，同时提供了额外选项以支持特定功能（如小米设备的特殊通知）。

在实际应用中，选择合适的API版本并正确设置title和body以及其他可选参数，可以确保消息或通知能够按照预期在不同平台和设备上正确显示。