
یادداشتها یکی از اجزاء اساسی هنگام ایجاد یک ارائه هستند. شما یادداشتهای سخنران را اضافه میکنید تا بعداً هنگام ارائه اسلاید شو در مقابل مخاطب به آنها مراجعه کنید. در طول ارائه، یادداشتهای سخنران بر روی مانیتور شما قابل مشاهده است اما برای مخاطب قابل مشاهده نیست. بنابراین، پنل یادداشتها محل ذخیره نکات گفتوگو است که میخواهید هنگام ارائه خود به آنها اشاره کنید.
Aspose.Slides Cloud امکاناتی را برای افزودن، بهروزرسانی یا حذف یادداشتها از اسلایدهای پاورپوینت ارائه میدهد. شما میتوانید این عملیات را بر روی اسلایدهای پاورپوینت موجود در درایو سیستم محلی یا ذخیرهشده در فضای ابری انجام دهید.
یادداشتها را به اسلایدها اضافه کنید
برای افزودن یادداشتها، شما باید از NotesSlide/PostAddNotesSlide استفاده کنید. فرمان cURL زیر به شما این امکان را میدهد که یادداشتها را به اسلایدهای پاورپوینت اضافه کنید.
curl -X POST "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide" -H "accept: application/json" -H "authorization: Bearer <jwt token>" -H "Content-Type: application/json" -d "{ \"Text\": \"These are sample presenter notes added using Aspose.Slides Cloud\",}"
درخواست URL
https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide
بدنه پاسخ
{<strong>
</strong>"text":** **"These are sample presenter notes added using Aspose.Slides Cloud",<strong>
</strong>"shapes":** **{<strong>
</strong>"uri":** **{<strong>
</strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide/shapes",<strong>
</strong>"relation":** **"self"<strong>
</strong>}<strong>
</strong>},<strong>
</strong>"selfUri":** **{<strong>
</strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide",<strong>
</strong>"relation":** **"self"<strong>
</strong>}<strong>
</strong>}
C#.NET code snippet
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// شیء Aspose.Slides Cloud را مقداردهی اولیه کنید
SlidesApi slidesApi = new SlidesApi(MyAppSid, MyAppKey);
String fileName = "NotesPresentation.pptx";
// NotesSlide dto object to represent the Slide notes
NotesSlide notesSlide = new NotesSlide();
// متن نمونه برای بخش یادداشتها
notesSlide.Text = "These are sample presenter notes added using Aspose.Slides Cloud";
// Create PostAddNotesSlideRequest object to add Notes to PPTX file
PostAddNotesSlideRequest postAddNotesSlideRequest = new PostAddNotesSlideRequest();
// نام فایل که باید یادداشتها به آن افزوده شود
postAddNotesSlideRequest.Name = fileName;
// ایندکس اسلاید در ارائه پاورپوینت
postAddNotesSlideRequest.SlideIndex = 1;
// شیء NotesSlide
postAddNotesSlideRequest.Dto = notesSlide;
// add NotesSlideRequest to SlidesApi instance
slidesApi.PostAddNotesSlide(postAddNotesSlideRequest);

تصویر 1:- اسلاید پاورپوینت بدون یادداشت

تصویر 2:- اسلاید پاورپوینت با یادداشتهای اضافه شده
به روز رسانی یادداشت های اسلاید
شما همچنین میتوانید از API برای بهروزرسانی یادداشتها در داخل ارائهی PowerPoint استفاده کنید. به منظور برآورده کردن این نیاز، از NotesSlide/PutUpdateNotesSlide استفاده میشود.
cURL command
curl -X PUT "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide" -H "accept: application/json" -H "authorization: Bearer <jwt token>" -H "Content-Type: application/json" -d "{ \"Text\": \"Notes updated using Aspose.Slides Cloud API\", \"Shapes\": { \"Uri\": { \"Href\": \"https://products.aspose.cloud/slides/curl\", \"Title\": \"Aspose.Slides Cloud for cURL\" } }}"
درخواست URL
https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide
بدنه پاسخ
{<strong>
</strong>"text":** **"Notes updated using Aspose.Slides Cloud API",<strong>
</strong>"shapes":** **{<strong>
</strong>"uri":** **{<strong>
</strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide/shapes",<strong>
</strong>"relation":** **"self"<strong>
</strong>}<strong>
</strong>},<strong>
</strong>"selfUri":** **{<strong>
</strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide",<strong>
</strong>"relation":** **"self"<strong>
</strong>}<strong>
</strong>}
C#.NET کد نمونه
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// شیء Aspose.Slides Cloud را مقداردهی اولیه کنید
SlidesApi slidesApi = new SlidesApi(MyAppSid, MyAppKey);
String fileName = "NotesPresentation.pptx";
// NotesSlide dto object to represent the Slide notes
NotesSlide notesSlide = new NotesSlide();
// متن نمونه برای ناحیه یادداشتها
notesSlide.Text = "Notes updated using Aspose.Slides Cloud API";
// یک شیء PutUpdateNotesSlideRequest برای بروزرسانی یادداشتها در داخل فایل PPTX ایجاد کنید
PutUpdateNotesSlideRequest putUpdateNotesSlideRequest = new PutUpdateNotesSlideRequest();
// نام فایل که یادداشتها باید به آن بهروزرسانی شود
putUpdateNotesSlideRequest.Name = fileName;
// شاخص اسلاید در ارائه پاورپوینت
putUpdateNotesSlideRequest.SlideIndex = 1;
// NotesSlide object
putUpdateNotesSlideRequest.Dto = notesSlide;
// add PutUpdateNotesSlideRequest to SlidesApi instance
slidesApi.PutUpdateNotesSlide(putUpdateNotesSlideRequest);

تصویر 3:- اسلاید با یادداشتهای بهروز شده
یادداشتهای اسلاید را بخوانید
API پردازش PowerPoint Cloud همچنین قابلیت خواندن یادداشتهای اسلاید موجود را ارائه میدهد. شما تنها نیاز دارید که نام فایل PowerPoint و ایندکس اسلایدی را که میخواهید جزئیات یادداشتها را از آن بخوانید، ارائه دهید. GetNotesSlide به شما این امکان را میدهد که این نیاز را برآورده کنید.
cURL command
curl -X GET "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide" -H "accept: application/json" -H "authorization: Bearer <jwt token>"
بدنه پاسخ
بدنه پاسخ یادداشتهای اسلاید را که از یک اسلاید خاص از ارائه پاورپوینت تجزیه شده است، نشان میدهد.
{<strong>
</strong>"text":** **"This is second slide of PowerPoint presentation",<strong>
</strong>"shapes":** **{<strong>
</strong>"uri":** **{<strong>
</strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide/shapes",<strong>
</strong>"relation":** **"self"<strong>
</strong>}<strong>
</strong>},<strong>
</strong>"selfUri":** **{<strong>
</strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide",<strong>
</strong>"relation":** **"self"<strong>
</strong>}<strong>
</strong>}
در صورتی که لازم است اطلاعات اسلاید نکات را برای یک سند ارائه شده در بدنه درخواست بخوانید، لطفاً سعی کنید از PostGetNotesSlide استفاده کنید.
حذف یادداشت های اسلاید
API روش DeleteNotesSlide را برای حذف/حذف یادداشتها از اسلاید پاورپوینت ارائه میدهد.
cURL command
curl -X DELETE "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide" -H "accept: application/json" -H "authorization: Bearer <jwt token>"

تصویر ۴:- اسلاید پاورپوینت با یادداشتهای حذف شده
تبدیل اسلاید یادداشتها به فرمت تصویر مشخص
شما ممکن است با الزامی برای تبدیل اسلایدهای پاورپوینت حاوی یادداشت به فرمتهای خاص تصویری مواجه شوید. به منظور برآورده کردن این نیاز، شما باید از GetNotesSlideWithFormat متد API استفاده کنید.
cURL command
curl -X GET "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide/Jpeg" -H "accept: multipart/form-data" -H "authorization: Bearer "
درخواست URL
https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide/Jpeg
در نتیجه، بدنه پاسخ حاوی یک تصویر تبدیل شده است که در زیر نمایش داده شده است.

تصویر ۵:- پیشنمایش اسلاید ۲ حاوی یادداشتها

تصویر 6:- اسلاید یادداشت پاورپوینت تبدیل شده به فرمت تصویر JPEG