Struct VideoClient

Source

pub struct VideoClient<'a> { /* private fields */ }

Expand description

视频领域 API 客户端。

Implementations§

Source §

impl<'a> VideoClient<'a>

Source

pub async fn coin_status( &self, params: VideoCoinStatusParams, ) -> BpiResult<VideoCoinStatusData>

检查当前账号已给视频投出多少硬币。

Self::coin 成功后，上游 endpoint 可能会短暂滞后。

Source

pub async fn like(&self, params: VideoLikeParams) -> BpiResult<Option<Value>>

点赞或取消点赞视频，并返回可选的标准 payload 结果。

Source

pub async fn coin(&self, params: VideoCoinParams) -> BpiResult<CoinData>

给视频投币，并返回标准 payload 结果。

Bilibili 的 Web endpoint 需要包含 buvid3 的正常登录 cookie 集合；即使存在 SESSDATA 和 bili_jct，缺少它的账号也可能触发风控。

Source

pub async fn favorite( &self, params: VideoFavoriteParams, ) -> BpiResult<FavoriteData>

将视频添加到收藏夹，或从收藏夹中移除。

Source §

impl<'a> VideoClient<'a>

Source

pub async fn view(&self, params: VideoViewParams) -> BpiResult<VideoView>

按 AV ID 或 BV ID 获取 Web 视频详情。

Examples found in repository ?

examples/module_clients.rs (line 19)

9async fn main() -> BpiResult<()> {
10    let client = client_from_env()?;
11    let video_params = VideoViewParams::from_bvid("BV1xx411c7mD".parse::<Bvid>()?);
12    let bangumi_params = BangumiInfoParams::new(MediaId::new(28_220_978)?);
13
14    if !run_live_example() {
15        println!("module-client 快速示例已编译；设置 BPI_RUN_EXAMPLE=1 后会发起真实网络请求");
16        return Ok(());
17    }
18
19    let video = client.video().view(video_params).await?;
20    println!("video: {}", video.title);
21
22    let bangumi = client.bangumi().info(bangumi_params).await?;
23    println!("bangumi: {}", bangumi.media.title);
24
25    if env::var_os("BPI_COOKIE").is_some() {
26        let nav = client.login().nav().await?;
27        println!("logged in: {}", nav.is_login);
28    }
29
30    Ok(())
31}

More examples

Hide additional examples

examples/video_info.rs (line 26)

21async fn main() -> BpiResult<()> {
22    let bvid = video_bvid()?;
23    let client = BpiClient::new()?;
24    let video = client.video();
25
26    let view = video.view(VideoViewParams::from_bvid(bvid.clone())).await?;
27    println!(
28        "视频: {} ({}) UP={} 播放={} 点赞={}",
29        view.title, view.bvid, view.owner.name, view.stat.view, view.stat.like
30    );
31
32    let pages = video
33        .page_list(VideoPageListParams::from_bvid(bvid.clone()))
34        .await?;
35    println!("分 P 数: {}", pages.len());
36    for page in pages.iter().take(5) {
37        println!("  P{} cid={} {}", page.page, page.cid, page.part);
38    }
39
40    let desc = video.desc(VideoDescParams::from_bvid(bvid)).await?;
41    let first_line = desc.lines().next().unwrap_or("");
42    println!("简介首行: {first_line}");
43
44    Ok(())
45}

Source

pub async fn detail(&self, params: VideoDetailParams) -> BpiResult<VideoDetail>

获取 Web 视频详情，包括标签和相关视频。

Source

pub async fn page_list( &self, params: VideoPageListParams, ) -> BpiResult<Vec<VideoPage>>

获取视频的分 P/内容 ID。

Examples found in repository ?

examples/video_info.rs (line 33)

21async fn main() -> BpiResult<()> {
22    let bvid = video_bvid()?;
23    let client = BpiClient::new()?;
24    let video = client.video();
25
26    let view = video.view(VideoViewParams::from_bvid(bvid.clone())).await?;
27    println!(
28        "视频: {} ({}) UP={} 播放={} 点赞={}",
29        view.title, view.bvid, view.owner.name, view.stat.view, view.stat.like
30    );
31
32    let pages = video
33        .page_list(VideoPageListParams::from_bvid(bvid.clone()))
34        .await?;
35    println!("分 P 数: {}", pages.len());
36    for page in pages.iter().take(5) {
37        println!("  P{} cid={} {}", page.page, page.cid, page.part);
38    }
39
40    let desc = video.desc(VideoDescParams::from_bvid(bvid)).await?;
41    let first_line = desc.lines().next().unwrap_or("");
42    println!("简介首行: {first_line}");
43
44    Ok(())
45}

Source

pub async fn desc(&self, params: VideoDescParams) -> BpiResult<String>

获取纯文本视频简介。

Examples found in repository ?

examples/video_info.rs (line 40)

21async fn main() -> BpiResult<()> {
22    let bvid = video_bvid()?;
23    let client = BpiClient::new()?;
24    let video = client.video();
25
26    let view = video.view(VideoViewParams::from_bvid(bvid.clone())).await?;
27    println!(
28        "视频: {} ({}) UP={} 播放={} 点赞={}",
29        view.title, view.bvid, view.owner.name, view.stat.view, view.stat.like
30    );
31
32    let pages = video
33        .page_list(VideoPageListParams::from_bvid(bvid.clone()))
34        .await?;
35    println!("分 P 数: {}", pages.len());
36    for page in pages.iter().take(5) {
37        println!("  P{} cid={} {}", page.page, page.cid, page.part);
38    }
39
40    let desc = video.desc(VideoDescParams::from_bvid(bvid)).await?;
41    let first_line = desc.lines().next().unwrap_or("");
42    println!("简介首行: {first_line}");
43
44    Ok(())
45}