如何通过Twilio API为iOS推送通知添加自定义音效？

我正在使用Twilio API向iOS设备发送推送通知，目前一切功能正常。但我希望为推送通知添加音效以吸引用户注意。
我尝试在payload中加入不同属性，比如sound: "default"以及指定自定义音效文件名，但均未成功播放音效。

当前发送通知的curl请求示例：

curl --location 'https://verify.twilio.com/v2/Services/{serviceId}/Entities/{identity}/Challenges' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic {base64}' \
--data-urlencode 'FactorSid=${factorSid}' \
--data-urlencode 'Details.Message=Please verify login attempt'

问题 #

1. 是否可以通过Twilio API为iOS用户提供自定义音效？
2. 我是否遗漏了某些步骤？
3. 是否有关于Twilio推送通知音效处理的专门文档？

解答 #

1. 是否支持自定义音效？

可以通过Twilio Verify API为iOS推送通知设置自定义音效，也可以调用系统默认音效，核心是要通过正确的参数将APNs所需的sound字段传递给Twilio。

2. 遗漏的关键步骤

你之前的操作没有正确构造APNs的自定义payload并通过Twilio的参数传递：

• 不能直接在基础参数中添加sound属性，需要使用Details.Push参数来指定完整的APNs payload，其中包含aps字典及sound字段
• 如果使用自定义音效，必须确保音效文件（格式为aiff、wav或caf）已正确添加到iOS项目的主Target资源中，文件名要与payload中指定的完全一致
• 修改后的curl请求示例（使用默认音效）：

curl --location 'https://verify.twilio.com/v2/Services/{serviceId}/Entities/{identity}/Challenges' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic {base64}' \
--data-urlencode 'FactorSid=${factorSid}' \
--data-urlencode 'Details.Message=Please verify login attempt' \
--data-urlencode 'Details.Push={"aps":{"sound":"default"}}'

• 如果使用自定义音效，将"default"替换为你的音效文件名即可，比如"custom_alert.caf"

3. 相关文档说明

Twilio Verify API的Challenges端点文档中明确说明了Details.Push参数的用途：该参数允许你传递自定义的APNs或FCM payload，其中就包含APNs标准的sound字段配置。文档中会详细说明Details参数的结构，覆盖推送通知自定义内容的处理逻辑。

内容的提问来源于stack exchange，提问作者Dmytro Pastovenskyi