Struct DownloadOption 

pub struct DownloadOption<'a> {
    pub audio_path: Option<&'a Path>,
    pub video_path: Option<&'a Path>,
    pub output: Option<&'a Path>,
    pub video_quality: Option<VideoQuality>,
    pub video_encode: Option<VideoEncode>,
    pub audio_quality: Option<AudioQuality>,
    pub ffmpeg_path: Option<&'a Path>,
    pub on_video_progress: Option<ProgressCallback>,
    pub on_audio_progress: Option<ProgressCallback>,
}

用于构造可选的下载参数

• audio_path: 输出的音频文件路径
• video_path: 输出视频(无音频)文件路径
• output: 指定最后合并视频音频后输出的视频的路径,其他下载方法(单独下视频和音频)不生效
• video_quality: 视频质量
• video_encode: 视频编码格式
• audio_quality: 音频质量
• ffmpeg_path: ffmpeg路径,不设置时从系统变量获取

Fields

audio_path: Option<&'a Path>

video_path: Option<&'a Path>

output: Option<&'a Path>

video_quality: Option<VideoQuality>

video_encode: Option<VideoEncode>

audio_quality: Option<AudioQuality>

ffmpeg_path: Option<&'a Path>

on_video_progress: Option<ProgressCallback>

on_audio_progress: Option<ProgressCallback>

Implementations

impl<'a> DownloadOption<'a>

pub fn builder() -> DownloadOptionBuilder<'a>

Examples found in repository

examples/download_audio.rs (line 18)

async fn main() -> Result<(), Box<dyn Error>> {
        let account = login::get_account().await?;
        let biliclient = BiliClient::new(&account)?;
        let bvid = "BV1JvPMedE5E";

        let resp = PlayUrlResponse::new(&biliclient, bvid).await?;
        fs::create_dir_all("output").await?;
        let option = DownloadOption::builder()
                .audio_path(Path::new("output/audio_example.m4a"))
                .build();
        actuator::download_audio(&biliclient, &resp, &option).await?;
        println!("The res is outputed to output/audio_example.m4a");
        Ok(())
}

examples/download_video_with_no_audio.rs (line 17)

async fn main() -> Result<(), Box<dyn Error>> {
        let account = login::get_account().await?;
        let biliclient = BiliClient::new(&account)?;
        let bvid = "BV1JvPMedE5E";

        let resp = PlayUrlResponse::new(&biliclient, bvid).await?;
        fs::create_dir_all("output").await?;
        let option = DownloadOption::builder()
                // potplayer低于v1.7.21759,尝试GPU解码av1编码格式时会有黑屏问题,这里用avc编码
                .video_encode(VideoEncode::AVC)
                .video_path(Path::new("output/video_example.mp4"))
                .build();
        actuator::download_video_with_no_audio(&biliclient, &resp, &option).await?;
        println!("The res is outputed to output/audio_example.mp4");
        Ok(())
}

examples/download_video.rs (line 17)

async fn main() -> Result<(), Box<dyn Error>> {
        let account = login::get_account().await?;
        let biliclient = BiliClient::new(&account)?;
        let bvid = "BV1JvPMedE5E";

        let resp = PlayUrlResponse::new(&biliclient, bvid).await?;
        fs::create_dir_all("output").await?;
        let option = DownloadOption::builder()
                // potplayer低于v1.7.21759,尝试GPU解码av1编码格式时会有黑屏问题,这里用avc编码
                .video_encode(VideoEncode::AVC)
                .audio_path(Path::new("output/audio_example.m4a"))
                .video_path(Path::new("output/video_example.mp4"))
                .output(Path::new("output/video_sample.mp4"))
                .build();
        actuator::download_video(&biliclient, &resp, &option).await?;
        println!("The video is outputed to output/video_sample.mp4");
        Ok(())
}

examples/download_audio_with_metadata.rs (line 36)

async fn main() -> Result<(), Box<dyn Error>> {
        let account = login::get_account().await?;
        let biliclient = BiliClient::new(&account)?;
        let bvid = "BV1JvPMedE5E";

        // 1. 拉取视频详细信息（标题、UP 主、简介、发布时间、分P）
        let detail = actuator::get_video_detail(bvid, Some(&biliclient)).await?;
        println!("标题: {}", detail.title);
        println!("UP 主: {}", detail.owner.name);
        println!("分区: {}", detail.tname);

        fs::create_dir_all("output").await?;
        let audio_path = Path::new("output/audio_with_metadata.m4a");

        // 2. 下载音频
        let resp = PlayUrlResponse::new(&biliclient, bvid).await?;
        let option = DownloadOption::builder().audio_path(audio_path).build();
        actuator::download_audio(&biliclient, &resp, &option).await?;

        // 3. 先看一下将要写入的元数据
        let meta = detail.media_meta(Some("我的收藏夹"), Some(detail.cid));
        println!("{:#?}", meta);

        // 4. 写入元数据 + 封面（已写入则自动跳过）
        actuator::embed_metadata(
                &biliclient,
                audio_path,
                &detail,
                Some("我的收藏夹"),
                Some(detail.cid),
        )
        .await?;

        // 5. 验证结果
        let tag = mp4ameta::Tag::read_from_path(audio_path)?;
        println!("----------------------------------------");
        println!("title:       {:?}", tag.title());
        println!("artist:      {:?}", tag.artist());
        println!("album:       {:?}", tag.album());
        println!("genre:       {:?}", tag.genre());
        println!("year:        {:?}", tag.year());
        println!("track:       {:?}", tag.track());
        println!("comment:     {:?}", tag.comment());
        println!("description: {:?}", tag.description());
        println!("keywords:    {:?}", tag.keywords().collect::<Vec<_>>());
        println!("encoder:     {:?}", tag.encoder());
        println!("cover:       {:?}", util::check_cover_box(audio_path)?);

        Ok(())
}