必应每日壁纸API封装

简介

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

1. async Task Main()
2. {
3.         try
4.         {
5.                 var bing = BingWallpaperAPI.CreateInstance(8); //初始化，参数8表示一共会加载8张图片
6.                 var task = await bing.Current();
7.                 task.Wallpaper.Dump();  //加载壁纸
8.                 Console.WriteLine("日期\t" + task.EndDate);
9.                 Console.WriteLine("标题\t" + task.Title);  //加载相关信息
10.                 Console.WriteLine("版权\t" + task.Copyright);
11.                 Console.WriteLine("链接\t" + task.CopyrightLink);
12.                 if (await bing.SaveCurrentWallpaper(@"D:\bing.jpg"))        //保存当前的壁纸
13.                 {
14.                         Console.WriteLine("保存成功");
15.                 };
16.                 var task1 = await bing.Next();  //加载下一张壁纸
17.                 task1.Wallpaper.Dump(); //打印壁纸
18.                 var task2 = await bing.Previous();  //加载上一张壁纸
19.                 task2.Wallpaper.Dump(); //打印壁纸
20.         }
21.         catch (Exception ex)
22.         {
23.                 Console.WriteLine(ex.Message);
24.         }
25. }

复制代码

效果预览

API封装

点击检察代码

1. using System;
2. using System.Diagnostics;
3. using System.Drawing.Imaging;
4. using System.Linq;
5. using System.Net.Http;
6. using System.Text.Json;
7. using System.Threading.Tasks;
9.    /// <summary>
10.    /// 加载Bing壁纸，单例，使用CreateInstance方法创建类的实例
11.    /// </summary>
12.    public sealed class BingWallpaperAPI
13.    {
14.        private static BingWallpaperAPI _instance = null;
15.        private static readonly object _padlock = new Object();
16.        /// <summary>
17.        /// 创建类的实例
18.        /// </summary>
19.        /// <param name="imgnums">壁纸的张数，可以是1-8之间的数</param>
20.        /// <returns></returns>
21.        public static BingWallpaperAPI CreateInstance(byte imgnums = 3)
22.        {
23.            if (_instance is null)
24.            {
25.                lock (_padlock)
26.                {
27.                    if (_instance is null) _instance = new BingWallpaperAPI(imgnums);
28.                }
29.            }
30.            return _instance;
31.        }
32.        private BingWallpaperAPI(byte imgnums)
33.        {
34.            if (imgnums > 8 || imgnums <= 0)
35.            {
36.                _imgnums = 3;
37.                Debug.WriteLine($"仅支持1-8张图片，你输入的{imgnums}被重置为3");
38.            }
39.            else { _imgnums = imgnums; }
40.            GetWallpaperLink();
41.        }
42.        /// <summary>内置索引</summary>
43.        private int _index = -1;
44.        /// <summary>
45.        /// 加载Bing壁纸的数量，默认为3
46.        /// </summary>
47.        private static byte _imgnums;
48.        private BingApiModel _bingApiModel;
49.        /// <summary>
50.        /// 加载壁纸的JSON格式文件，文件中包含了壁纸的下载地址等关键信息
51.        /// </summary>
52.        /// <exception cref="Exception"></exception>
53.        private void GetWallpaperLink()
54.        {
55.            HttpClient client = new HttpClient();
56.            for (int i = 0; i < 3; i++) //这个步骤会尝试3次
57.            {
58.                try
59.                {
60.                    var res = client.GetAsync($"https://cn.bing.com/HPImageArchive.aspx?format=js&idx=0&n={_imgnums}&mkt=zh-CN").Result;
61.                    //参数n:1-8 返回请求数量，目前最多一次获取8张
62.                    //参数format:js/xml
63.                    //参数idx:请求图片截止天数 0 今天;1 截止至昨天，类推（目前最多获取到7天前的图片）
64.                    //参数mkt:地区
65.                    var json = res.Content.ReadAsStringAsync().Result;
66.                    BingApiModel bingApiModel = new BingApiModel();
67.                    _bingApiModel = JsonSerializer.Deserialize<BingApiModel>(json);
68.                    ImageCount = _bingApiModel.images.Count();
69.                    if (ImageCount == _imgnums)
70.                    {
71.                        break;  //加载成功时直接终止循环
72.                    }
73.                }
74.                catch (Exception ex)
75.                {
76.                    if (i == 2) { throw ex; } else Console.WriteLine(ex.Message);
77.                }
78.            }
79.        }
80.        /// <summary>
81.        /// 根据JSON数据下载壁纸
82.        /// </summary>
83.        /// <param name="index">_bingApiModel索引</param>
84.        /// <returns></returns>
85.        /// <exception cref="Exception"></exception>
86.        private async Task<BingWallpaper> GetWallpaper(int index)
87.        {
88.            try
89.            {
90.                using (HttpClient client = new HttpClient())
91.                {
92.                    var element = _bingApiModel.images[index];
93.                    var res = await client.GetAsync("https://cn.bing.com" + element.url);
94.                    //这个URL中的第一个1920x1080改成UHD是4k
95.                    var imgStream = await res.Content.ReadAsStreamAsync();
96.                    return (new BingWallpaper()
97.                    {
98.                        Wallpaper = System.Drawing.Image.FromStream(imgStream),
99.                        Title = element.title,
100.                        Copyright = element.copyright,
101.                        CopyrightLink = element.copyrightlink,
102.                        EndDate = element.enddate,
103.                    });
104.                }
105.            }
106.            catch (Exception ex)
107.            {
108.                throw ex;
109.            }
110.        }
111.        /// <summary>
112.        /// 加载JSON数据包含的URL数量
113.        /// </summary>
114.        public int ImageCount { get;private set; }
115.        /// <summary>
116.        /// 下一张壁纸
117.        /// </summary>
118.        /// <returns></returns>        
119.        /// <exception cref="Exception"></exception>
120.        public async Task<BingWallpaper> Next()
121.        {
122.            if (ImageCount == 0)
123.            {
124.                return null;
125.            }
126.            _index++;
127.            if (_index >= ImageCount)   //重置索引
128.            {
129.                _index = 0;
130.            }
131.            return await GetWallpaper(_index);
132.        }
133.        /// <summary>
134.        /// 上一张壁纸
135.        /// </summary>
136.        /// <returns></returns>
137.        /// <exception cref="Exception"></exception>
138.        public async Task<BingWallpaper> Previous()
139.        {
140.            if (ImageCount == 0)
141.            {
142.                return null;
143.            }
144.            _index--;
145.            if (_index < 0)
146.            {
147.                _index = ImageCount - 1;    //重置索引
148.            }
149.            return await GetWallpaper(_index);
150.        }
152.        /// <summary>
153.        /// 保存当前的壁纸到本地
154.        /// </summary>
155.        /// <param name="path">保存的路径、含文件名（如c:\1.jpg），格式为JPEG</param>
156.        /// <returns>保存是否成功</returns>
157.        /// <exception cref="Exception"></exception>
158.        public async Task<bool> SaveCurrentWallpaper(string path)
159.        {
160.            try
161.            {
162.                var task = await Current();
163.                task.Wallpaper.Save(path, ImageFormat.Jpeg);
164.                return true;
165.            }
166.            catch (Exception ex)
167.            {
168.                throw ex;
169.            }
170.        }
171.        /// <summary>
172.        /// 当前壁纸
173.        /// </summary>
174.        /// <returns></returns>
175.        /// <exception cref="Exception"></exception>
176.        public async Task<BingWallpaper> Current()
177.        {
178.            if (ImageCount == 0)
179.            {
180.                return null;
181.            }
182.            if (_index == -1)
183.            {
184.                _index = 0;
185.            }
186.            return await GetWallpaper(_index);
187.        }
188.    }
189.    /// <summary>
190.    /// 用来保存壁纸信息的类模型
191.    /// </summary>
192.    public class BingWallpaper
193.    {
194.        /// <summary>壁纸</summary>
195.        public System.Drawing.Image Wallpaper { get; set; }
196.        /// <summary>标题</summary>
197.        public string Title { get; set; }
198.        /// <summary>版权</summary>
199.        public string Copyright { get; set; }
200.        /// <summary>版权链接</summary>
201.        public string CopyrightLink { get; set; }
202.        /// <summary>
203.        /// 壁纸所属日期
204.        /// </summary>
205.        public string EndDate { get; set; }
206.    }
207.    /// <summary>
208.    /// 用来解析JSON数据的类模型
209.    /// </summary>
210.    public class BingApiModel
211.    {
212.        /// <summary>
213.        /// 返回图片集合
214.        /// </summary>
215.        public Image[] images { get; set; }
216.    }
217.    public class Image
218.    {
219.        /// <summary>
220.        /// 每日壁纸的日期
221.        /// </summary>
222.        public string enddate { get; set; }
223.        /// <summary>
224.        /// 壁纸的地址
225.        /// </summary>
226.        public string url { get; set; }
227.        /// <summary>壁纸的简述、拍摄地址(摄影人)</summary>
228.        public string copyright { get; set; }
229.        /// <summary>壁纸相关搜索链接</summary>
230.        public string copyrightlink { get; set; }
231.        /// <summary>壁纸的标题</summary>
232.        public string title { get; set; }
233.    }

复制代码

原创声明

作者：落水的月亮
出处：博客园
转载：可以转载，转载必须注明出处。必须在文章中给出原文连接。
必应主页

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。