类型 函数 库 audio.* 返回值 布尔值 修订 版本 2024.3703 关键词 audio, seek, 位置 另请参阅 audio.rewind()
跳转到活动频道或直接在音频句柄上的时间位置。
此函数在成功时返回 true，否则返回 false。
根据您是使用 audio.loadSound() 还是 audio.loadStream() 加载您尝试查找的内容，行为会略有不同。
对于使用 audio.loadSound() 预加载的音频，您只能使用包含 channel 参数的 options 表参数进行查找。您**不能**使用 audioHandle 参数进行查找。这是因为 audio.loadSound() 经过优化以共享音频数据，以便您可以同时播放声音的多个实例（在不同的位置）。查找底层数据会使此优化复杂化。
相反，对于使用 audio.loadStream() 加载的流式音频，您应该使用 audioHandle 参数进行查找，但如果您使用 channel 参数查找流式数据，它将自动查找，如同您使用了 audioHandle 参数一样（因此，您可以安全地指定任一参数）。
另请注意，对于使用 audio.loadStream() 加载的当前正在播放的文件，您可能无法立即听到音频更新，直到当前缓冲区播放完毕。如果您希望看似“即时”的查找，则应先使用 audio.stop() 停止播放，然后查找，再开始播放。
audio.seek( time [, audioHandle ] [, options ] )
数字。 您要查找的音频句柄中的时间（以毫秒为单位）。
对象。 您要查找的数据的音频句柄。这应该仅用于使用 audio.loadStream() 加载的音频。不要在同一调用中使用 options.channel 参数。
表。 支持单个键 channel 的表，该键是您希望查找操作应用到的频道。这最适合使用 audio.loadSound() 加载的音频。不要在同一调用中使用 audioHandle 参数。
audio.seek( 5000, { channel=1 } ) -- Seek channel 1 to 5 seconds
audio.seek( 4000, backgroundMusic ) -- Seek the audio handle to 4 seconds