『玩转Streamlit』--图像与媒体组件

Streamlit中的图像与媒体组件，主要是st.image、st.audio和st.video。

它们是专为在Streamlit Web应用程序中嵌入和展示多媒体内容而设计的，这些组件不仅丰富了应用程序的呈现形式，还极大地提升了用户体验和互动性。

1. st.image

st.image函数用于在Streamlit应用程序中展示图像内容，增强视觉呈现效果。

比如，在数据可视化的场景中，通过st.image展示数据分析结果，如柱状图、折线图等；

在项目展示时，也可以通过在项目中嵌入产品图片、示意图等，提升用户理解。

它的主要参数有：

名称	类型	说明
image	numpy.ndarray / [numpy.ndarray] / BytesIO / str / [str]	要显示的图像，也可以指定一个图像URL或URL列表
caption	str/[str]	图像标题，如果显示多幅图像，应当是字符串列表
width	int / None	图像宽度，None表示使用图像自身宽度
clamp	bool	是否将图像的像素值压缩到有效域（0~255），仅对字节数组图像有效
channels	"RGB" / "BGR"	图像通道类型
output_format	"JPEG" / "PNG" / "auto"	图像格式
use_container_width	bool	如果设置为True，则使用列宽作为图像宽度

1.1. 使用示例

展示本地图像文件，通过image参数接受PIL图像对象，caption参数为图像添加标题，

width参数设置了图像的显示宽度。

import streamlit as st
from PIL import Image

# 读取本地图像文件
image = Image.open("path/to/your/image.jpg")

# 使用st.image展示图像，并设置标题和宽度
st.image(image, caption="这是一张本地图片", width=300)

展示URL图像，并使用use_column_width参数使图像宽度自适应Streamlit列的宽度。

# 图像URL
image_url = "http://xxx.com/xxx.jpeg"

# 使用st.image展示URL图像，并设置使用列宽
st.image(
    image_url,
    use_column_width=True,
    caption="这是一张网络图片",
)

图片的宽度会随着浏览器窗口的大小自适应变化。

2. st.audio

st.audio函数用于在Streamlit应用程序中嵌入音频内容，为数据分析结果添加声音效果，增强表现力。

它的主要参数有：

名称	类型	说明
data	str / bytes / BytesIO / numpy.ndarray / file	要播放的音频数据，可以是字节码流、numpy.ndarray或打开的文件
format	str	音频文件的MIME类型，如'audio/ogg'、'audio/mp3'等
start_time	int / float / timedelta / str / None	指定音频播放的起始时间
sample_rate	int / None	音频的采样率，播放音频时，通常不需要直接设置这个参数
end_time	int / float / timedelta / str / None	指定音频播放的结束时间
loop	bool	是否循环播放音频
autoplay	bool	是否自动播放音频

2.1. 使用示例

播放本地音频文件，autoplay参数设置为True，使音频自动播放。

import streamlit as st

# 打开本地音频文件
audio_file = open("path/to/your/audio.mp3", "rb")
audio_bytes = audio_file.read()

# 使用st.audio播放音频，并自动播放
st.audio(
    audio_bytes,
    format="audio/mp3",
    autoplay=True,
)

运行之后会自动播放。

和st.image一样，音频也可以传入URL，直接播放在线的音频。

3. st.video

st.video函数用于在Streamlit应用程序中嵌入视频内容，通过视频展示分析结果的特点或分析过程。

它的主要参数有：

名称	类型	说明
data	str / bytes / BytesIO / numpy.ndarray / file	要播放的视频数据，可以是URL字符串、字节码流、numpy.ndarray或打开的文件
format	str	视频文件的MIME类型，如'video/mp4'，默认值为'video/mp4'
start_time	int / float / timedelta / str / None	视频开始播放的时间
subtitles	str / bytes / Path / io.BytesIO / dict	视频字幕数据
end_time	int / float / timedelta / str / None	视频结束播放的时间
loop	bool	是否循环播放视频
autoplay	bool	是否自动播放视频
muted	bool	是否静音播放

3.1. 使用示例

播放本地视频文件, 通过start_time和end_time参数设置了视频播放开始和结束的时间（秒）。

import streamlit as st

# 打开本地视频文件
video_file = open('path/to/your/video.mp4', 'rb')
video_bytes = video_file.read()

# 使用st.video播放视频，并设置标题和开始时间
st.video(
    video_bytes,
    format="video/mp4",
    start_time=5,
    end_time=10,
)

运行之后，视频加载后停在5s的位置，点击播放，播放到10s时自动停止。

4. 总结

总之，st.image、st.audio和st.video这三个组件共同构成了Streamlit中强大的多媒体展示工具集。

它们各自专注于图像、音频和视频的展示与播放，通过丰富的参数设置和灵活的嵌入方式，为开发者提供了极大的便利和创意空间。

无论是构建数据可视化应用、产品展示页面还是在线教育平台，这些组件都能帮助开发者轻松实现多媒体内容的嵌入与呈现。