iOS特定Twilio音频URL无法通过createAsync加载问题排查

问题背景 #

基于Twilio Conversations实现消息功能，Android端音频、视频、文本功能均正常；iOS端视频功能正常，但特定Twilio生成的音频URL无法通过Expo Audio的createAsync()加载。直接在浏览器打开该URL可正常播放，将音频下载后放到临时服务器，用临时URL也能正常加载，仅原Twilio URL存在问题。

可能原因及解决办法 #

1. URL特殊字符未正确编码 #

Twilio的签名URL包含~等特殊字符，浏览器可自动处理，但Expo Audio的createAsync()可能无法解析未编码的特殊字符。

解决代码：

const handleAudioPress = async (audioUrl: string) => {
  // ... 原有逻辑
  try {
    setLoadingAudio(true);
    // 对URL进行URI编码
    const encodedUrl = encodeURI(audioUrl);
    const { sound } = await Audio.Sound.createAsync(
      { uri: encodedUrl },
      { shouldPlay: true }
    );
    // ... 后续播放逻辑
  } catch (error) {
    console.error("Error details:", JSON.stringify(error, null, 2));
  } finally {
    setLoadingAudio(false);
  }
};

2. CORS或ATS限制 #

iOS的App Transport Security（ATS）对跨域请求有严格限制，Twilio媒体URL的响应头可能未配置允许你的APP的跨域规则，导致请求被拦截。

方案A：配置ATS例外

在app.json中添加Twilio媒体域名的ATS例外：

{
  "expo": {
    "ios": {
      "infoPlist": {
        "NSAppTransportSecurity": {
          "NSExceptionDomains": {
            "media.us1.twilio.com": {
              "NSIncludesSubdomains": true,
              "NSAllowsArbitraryLoads": true
            }
          }
        }
      }
    }
  }
}

方案B：先下载音频到本地再播放

绕开跨域限制，将音频下载到设备缓存目录后播放：

import * as FileSystem from 'expo-file-system';

const handleAudioPress = async (audioUrl: string) => {
  if (playbackInstance) {
    await playbackInstance.unloadAsync();
    setPlaybackInstance(null);
    setCurrentPlayingUrl(null);
  }

  if (currentPlayingUrl !== audioUrl) {
    try {
      setLoadingAudio(true);
      // 下载到缓存目录
      const localPath = `${FileSystem.cacheDirectory}twilio_audio_${Date.now()}.mp3`;
      await FileSystem.downloadAsync(audioUrl, localPath);
      // 用本地路径创建音频实例
      const { sound } = await Audio.Sound.createAsync(
        { uri: localPath },
        { shouldPlay: true }
      );
      setPlaybackInstance(sound);
      setCurrentPlayingUrl(audioUrl);

      await sound.playAsync();

      sound.setOnPlaybackStatusUpdate((status) => {
        if (status.isLoaded && !status.isPlaying) {
          setCurrentPlayingUrl(null);
          setPlaybackInstance(null);
          // 删除临时文件
          FileSystem.deleteAsync(localPath).catch(err => console.log(err));
        }
      });
    } catch (error) {
      console.error("Error playing audio:", JSON.stringify(error, null, 2));
    } finally {
      setLoadingAudio(false);
    }
  }
};

3. 捕获详细错误信息定位问题 #

默认的错误日志可能不够详细，打印完整错误对象获取AVFoundation的具体错误码：

catch (error) {
  console.error("Full error:", JSON.stringify(error, Object.getOwnPropertyNames(error), 2));
}

例如错误码-43表示文件找不到，可能是URL解析问题；错误码-10851表示音频格式不支持，需检查编码兼容性。

4. 检查音频格式兼容性 #

iOS的AVFoundation仅支持特定音频编码（如AAC-LC、MP3 MPEG-1/2 Layer 3），可通过工具检查Twilio音频的编码信息：

# 使用ffmpeg查看音频信息
ffmpeg -i "your-twilio-audio-url"

若编码不兼容，可通过Twilio的媒体转换API将音频转成iOS支持的格式，或在下载后进行转码。

内容的提问来源于stack exchange，提问作者Nauman Jafar