必应每日壁纸API封装

简介

这个类封装了必应首页的每日壁纸查看功能，提供了查看、保存壁纸的方法，最大支持查看近8天的壁纸

使用方法

async Task Main()
{
	try
	{
		var bing = BingWallpaperAPI.CreateInstance(8); //初始化，参数8表示一共会加载8张图片
		var task = await bing.Current();
		task.Wallpaper.Dump();  //加载壁纸
		Console.WriteLine("日期\t" + task.EndDate);
		Console.WriteLine("标题\t" + task.Title);  //加载相关信息
		Console.WriteLine("版权\t" + task.Copyright);
		Console.WriteLine("链接\t" + task.CopyrightLink);
		if (await bing.SaveCurrentWallpaper(@"D:\bing.jpg"))	//保存当前的壁纸
		{
			Console.WriteLine("保存成功");
		};
		var task1 = await bing.Next();  //加载下一张壁纸
		task1.Wallpaper.Dump(); //打印壁纸
		var task2 = await bing.Previous();  //加载上一张壁纸
		task2.Wallpaper.Dump(); //打印壁纸
	}
	catch (Exception ex)
	{
		Console.WriteLine(ex.Message);
	}
}

效果预览

---

API封装

点击查看代码

using System;
using System.Diagnostics;
using System.Drawing.Imaging;
using System.Linq;
using System.Net.Http;
using System.Text.Json;
using System.Threading.Tasks;

   /// <summary>
   /// 加载Bing壁纸，单例，使用CreateInstance方法创建类的实例
   /// </summary>
   public sealed class BingWallpaperAPI
   {
       private static BingWallpaperAPI _instance = null;
       private static readonly object _padlock = new Object();
       /// <summary>
       /// 创建类的实例
       /// </summary>
       /// <param name="imgnums">壁纸的张数，可以是1-8之间的数</param>
       /// <returns></returns>
       public static BingWallpaperAPI CreateInstance(byte imgnums = 3)
       {
           if (_instance is null)
           {
               lock (_padlock)
               {
                   if (_instance is null) _instance = new BingWallpaperAPI(imgnums);
               }
           }
           return _instance;
       }
       private BingWallpaperAPI(byte imgnums)
       {
           if (imgnums > 8 || imgnums <= 0)
           {
               _imgnums = 3;
               Debug.WriteLine($"仅支持1-8张图片，你输入的{imgnums}被重置为3");
           }
           else { _imgnums = imgnums; }
           GetWallpaperLink();
       }
       /// <summary>内置索引</summary>
       private int _index = -1;
       /// <summary>
       /// 加载Bing壁纸的数量，默认为3
       /// </summary>
       private static byte _imgnums;
       private BingApiModel _bingApiModel;
       /// <summary>
       /// 加载壁纸的JSON格式文件，文件中包含了壁纸的下载地址等关键信息
       /// </summary>
       /// <exception cref="Exception"></exception>
       private void GetWallpaperLink()
       {
           HttpClient client = new HttpClient();
           for (int i = 0; i < 3; i++) //这个步骤会尝试3次
           {
               try
               {
                   var res = client.GetAsync($"https://cn.bing.com/HPImageArchive.aspx?format=js&idx=0&n={_imgnums}&mkt=zh-CN").Result;
                   //参数n:1-8 返回请求数量，目前最多一次获取8张
                   //参数format:js/xml
                   //参数idx:请求图片截止天数 0 今天;1 截止至昨天，类推（目前最多获取到7天前的图片）
                   //参数mkt:地区
                   var json = res.Content.ReadAsStringAsync().Result;
                   BingApiModel bingApiModel = new BingApiModel();
                   _bingApiModel = JsonSerializer.Deserialize<BingApiModel>(json);
                   ImageCount = _bingApiModel.images.Count();
                   if (ImageCount == _imgnums)
                   {
                       break;  //加载成功时直接终止循环
                   }
               }
               catch (Exception ex)
               {
                   if (i == 2) { throw ex; } else Console.WriteLine(ex.Message);
               }
           }
       }
       /// <summary>
       /// 根据JSON数据下载壁纸
       /// </summary>
       /// <param name="index">_bingApiModel索引</param>
       /// <returns></returns>
       /// <exception cref="Exception"></exception>
       private async Task<BingWallpaper> GetWallpaper(int index)
       {
           try
           {
               using (HttpClient client = new HttpClient())
               {
                   var element = _bingApiModel.images[index];
                   var res = await client.GetAsync("https://cn.bing.com" + element.url);
                   //这个URL中的第一个1920x1080改成UHD是4k
                   var imgStream = await res.Content.ReadAsStreamAsync();
                   return (new BingWallpaper()
                   {
                       Wallpaper = System.Drawing.Image.FromStream(imgStream),
                       Title = element.title,
                       Copyright = element.copyright,
                       CopyrightLink = element.copyrightlink,
                       EndDate = element.enddate,
                   });
               }
           }
           catch (Exception ex)
           {
               throw ex;
           }
       }
       /// <summary>
       /// 加载JSON数据包含的URL数量
       /// </summary>
       public int ImageCount { get;private set; }
       /// <summary>
       /// 下一张壁纸
       /// </summary>
       /// <returns></returns>
       /// <exception cref="Exception"></exception>
       public async Task<BingWallpaper> Next()
       {
           if (ImageCount == 0)
           {
               return null;
           }
           _index++;
           if (_index >= ImageCount)   //重置索引
           {
               _index = 0;
           }
           return await GetWallpaper(_index);
       }
       /// <summary>
       /// 上一张壁纸
       /// </summary>
       /// <returns></returns>
       /// <exception cref="Exception"></exception>
       public async Task<BingWallpaper> Previous()
       {
           if (ImageCount == 0)
           {
               return null;
           }
           _index--;
           if (_index < 0)
           {
               _index = ImageCount - 1;    //重置索引
           }
           return await GetWallpaper(_index);
       }

       /// <summary>
       /// 保存当前的壁纸到本地
       /// </summary>
       /// <param name="path">保存的路径、含文件名（如c:\1.jpg），格式为JPEG</param>
       /// <returns>保存是否成功</returns>
       /// <exception cref="Exception"></exception>
       public async Task<bool> SaveCurrentWallpaper(string path)
       {
           try
           {
               var task = await Current();
               task.Wallpaper.Save(path, ImageFormat.Jpeg);
               return true;
           }
           catch (Exception ex)
           {
               throw ex;
           }
       }
       /// <summary>
       /// 当前壁纸
       /// </summary>
       /// <returns></returns>
       /// <exception cref="Exception"></exception>
       public async Task<BingWallpaper> Current()
       {
           if (ImageCount == 0)
           {
               return null;
           }
           if (_index == -1)
           {
               _index = 0;
           }
           return await GetWallpaper(_index);
       }
   }
   /// <summary>
   /// 用来保存壁纸信息的类模型
   /// </summary>
   public class BingWallpaper
   {
       /// <summary>壁纸</summary>
       public System.Drawing.Image Wallpaper { get; set; }
       /// <summary>标题</summary>
       public string Title { get; set; }
       /// <summary>版权</summary>
       public string Copyright { get; set; }
       /// <summary>版权链接</summary>
       public string CopyrightLink { get; set; }
       /// <summary>
       /// 壁纸所属日期
       /// </summary>
       public string EndDate { get; set; }
   }
   /// <summary>
   /// 用来解析JSON数据的类模型
   /// </summary>
   public class BingApiModel
   {
       /// <summary>
       /// 返回图片集合
       /// </summary>
       public Image[] images { get; set; }
   }
   public class Image
   {
       /// <summary>
       /// 每日壁纸的日期
       /// </summary>
       public string enddate { get; set; }
       /// <summary>
       /// 壁纸的地址
       /// </summary>
       public string url { get; set; }
       /// <summary>壁纸的简述、拍摄地址(摄影人)</summary>
       public string copyright { get; set; }
       /// <summary>壁纸相关搜索链接</summary>
       public string copyrightlink { get; set; }
       /// <summary>壁纸的标题</summary>
       public string title { get; set; }
   }

原创声明

作者：落水的月亮

出处：博客园

转载：可以转载，转载必须注明出处。必须在文章中给出原文连接。

---

必应主页