Aby efektywnie korzystać z interfejsu API Prezentacji, musisz znać architekturę prezentacji i ich komponentów, a także interakcje między tymi komponentami. Na tej stronie znajdziesz szczegółowe omówienie tych kategorii: tematy:
- Ogólny model komponentów prezentacji
- Jak interfejs API przedstawia te komponenty
- Właściwości stylu komponentów
Lepiej zapoznać się z omówieniem tej i innych pojęć, i skorzystaj z instrukcji, instrukcji z dokumentacją i przepisem .
Prezentacje, strony i elementy strony
Najbardziej zewnętrznym elementem kontenera w Prezentacjach Google jest prezentacja. To jest Ta jednostka, którą można zapisać na Dysku Google, udostępnić innym użytkownikom itd.
Każda prezentacja zawiera różne typy stron. Jednym z typów stron jest slajd, czyli strony, na których użytkownicy mogą przełączać się między prezentacją renderowaną na ekranie.
Każda strona zawiera szereg elementów, które razem składają się na zawartość strony, zgodnie z poniższym diagramem:
Poza slajdami są też inne typy stron, które umożliwiają zastosowanie projektowania do wiele różnych slajdów, co daje spójny wygląd. Inne typy stron to elementy główne i układy, a ich właściwości określają sposób wyświetlania slajdów jak na tym diagramie:
Wzorce – strona wzorcowa służy do dwóch celów. Obiekty zastępcze na elemencie głównym zawierają domyślne style tekstu używane w prezentacji. tło i wszystkie inne kształty na slajdzie głównym tworzą domyślne tła wszystkich slajdów na podstawie tego elementu głównego. Jeśli masz logo firmy, które mają być widoczne na każdym slajdzie w prezentacji, umieść go na slajdzie głównym.
Układy – szablony układów określają sposób rozmieszczenia treści na każdym typie slajdu. Jeśli chcesz, aby wszystkie slajdy tytułowe wyglądały w określony sposób, na przykład możesz na przykład edytować szablon układu tytułu.
Są dwa dodatkowe rodzaje stron – strony z notatkami i strony z notatkami – które zawierają przydają się przede wszystkim podczas pracy z notatkami dla prelegenta.
Typy i struktura reprezentacji interfejsu API
W tej sekcji opisano koncepcyjny model koncepcyjny Prezentacji Google. jest reprezentowana w interfejsie API Prezentacji.
Poniższy diagram przedstawia zależności między prezentacjami, stronami i elementów strony jako typy w interfejsie Prezentacji API:
W sekcjach poniżej pokazujemy, jak te typy są przedstawiane w formacie JSON.
Prezentacje
Prezentacja zawiera: liczby usług i zawiera znajdujące się w nich strony:
{
"presentationId": string,
"pageSize": { object(Size) },
"slides": [ { object(Page) } ],
"title": string,
"masters": [ { object(Page) } ],
"layouts": [ { object(Page) } ],
"notesMaster": object(Page),
"locale": string,
}
Pages
Strona zawiera zestaw i zawiera zawarte w niej elementy strony:
{
"objectId": string,
"pageType": enum(PageType),
"pageElements": [ { object(PageElement) } ],
"pageProperties": { object(PageProperties) },
// Union field properties can be only one of the following:
"slideProperties": { object(SlideProperties) },
"layoutProperties": { object(LayoutProperties) },
"notesProperties": { object(NotesProperties) },
// End of list of possible types for union field properties.
}
Elementy strony
Elementy strony czyli komponentów wizualnych umieszczanych na stronach. element strony w interfejsie API; zawiera wiele właściwości, w tym pole, które zmienia się w zależności rodzaj elementu strony:
{
"objectId": string,
"size": { object(Size) },
"transform": { object(AffineTransform) },
"title": string,
"description": string,
// Union field element_kind can be only one of the following:
"elementGroup": { object(Group) },
"shape": { object(Shape) },
"image": { object(Image) },
"video": { object(Video) },
"line": { object(Line) },
"table": { object(Table) },
"wordArt": { object(WordArt) },
"sheetsChart": { object(SheetsChart) },
// End of list of possible types for union field element_kind.
}
Istnieje kilka rodzajów elementów strony zdefiniowanych w polu sumy
element_kind w powyższej definicji. Tego rodzaju elementy strony
opisane w poniższej tabeli:
| Rodzaj elementu | Opis |
|---|---|
| Grupa | Zestaw elementów strony traktowanych jako osobna jednostka. Można je przesuwać, skalować i obracać razem. |
| Kształt | Zwykły obiekt wizualny, taki jak prostokąty, wielokropki i pola tekstowe. Kształty mogą zawierać tekst, więc są najczęstszym elementem strony do tworzenia slajdów. |
| Obraz | Grafika zaimportowana do Prezentacji Google. |
| Wideo | Film zaimportowany do Prezentacji Google. |
| Linia | Linia wizualna, krzywa lub łącznik. |
| Tabela | Siatka treści. |
| WordArt | Wizualny element tekstowy zawierający tekst, który przypomina kształt. |
| SheetsChart | Wykres zaimportowany do Prezentacji z Arkuszy Google. |
Właściwości strony i elementów strony
Interfejs Prezentacji API umożliwia odczytywanie i aktualizowanie wyglądu stron i stron elementy prezentacji. Obsługa różnych elementów strony różne właściwości, które kontrolują sposób renderowania elementu strony.
Każdy rodzaj elementów strony ma odpowiedni element właściwości i właściwości zaktualizować wiadomość, na przykład:
- Element strony typu Kształt
- Pole właściwości to shapeProperties.
- Żądanie zaktualizowania tych właściwości jest wysyłane w następujący sposób: UpdateShapePropertiesRequest
Każdy element strony ma ten sam zestaw żądań aktualizacji, właściwości lub elementów. type: Image/imageProperties/UpdateImageProperties, i tak dalej.
Atrybut właściwości możesz odczytać w dowolnym miejscu, gdy znajdziesz go na stronie element; , aby zmienić w nim wartości, użyj go z typem pasującego żądania jako ładunek dla batchUpdate co pozwala zmienić te wartości w prezentacji.
Rodzaje właściwości
Istnieje kilka właściwości, które są wspólne dla kilku rodzajów obiektów w argumencie interfejs API Prezentacji:
| Właściwość | Opis |
|---|---|
| Kolor | Kolory w interfejsie Prezentacji API mogą być wartością RGB lub odwołaniem do koloru motywu. Kolory motywu są określane za pomocą nazwy (np. „DARK1”) i można je przyporządkować do wartości RGB przy użyciu schematu kolorów strony. Ten schemat kolorów jest zwykle aktualizowany podczas zmiany motywu prezentacji w edytorze Prezentacji. |
| Wypełnienie | Wypełnienie reprezentuje wyrenderowanie pustej przestrzeni w obiekcie. Najczęściej obsługiwanym wypełnieniem w Prezentacjach jest wypełnienie pełne, w którym wnętrze obiektu jest wypełniane jednym jednolitym kolorem. Wypełnień można też używać jako tła stron. |
| Konspekt | Konspekt reprezentuje zestaw linii otaczających element strony. Kolorem linii określa się wypełnienie. Rozmówca może też dostosować szerokość i styl konturu kont. |
| Cień | Cień to efekt wizualny mający naśladować fizyczny cień rzucany przez obiekt. Obecnie cienie w interfejsie Prezentacji API są tylko do odczytu. |
Aktualizowanie usług
Aby zaktualizować usługę, użyj odpowiedniego
Żądanie Update...Properties w
batchUpdate
na przykład UpdateShapeProperties w przypadku Kształtów. Żądania te
akceptowalny komunikat o wszystkich właściwościach i można użyć
masek pól do określania, które pola w
właściwości.
Dziedziczenie w usługach
Strona lub element strony może dziedziczyć właściwości z obiektów nadrzędnych. An właściwości obiektu, w tym zdefiniowanych przez niego i właściwości, określa ostateczny wygląd.
- Właściwości strony – strona dziedziczy wszystkie właściwości, których nie ma. ale są zdefiniowane w układzie lub wzorcu, na których jest oparty.
- Właściwości kształtu – można oznaczyć kształt jako obiekt zastępczy. jawnie odwołujesz się do innego kształtu zastępczego (w układzie nadrzędnym strony lub master)), z której mają odziedziczyć właściwości.
Wyjaśnienia te zostały szczegółowo omówione w dalszej części artykułu.
Dziedziczenie właściwości strony
Struktura slajdów, układów i elementów głównych określa hierarchię dziedziczenia w prezentacji: slajdy dziedziczą elementy z układów, a układy – z mistrzowie. Nadrzędny układ i element główny slajdu są określone w elemencie slideProperties .
Strona może dziedziczyć właściwości takie jak background i schemat kolorów, na stronie nadrzędnej. Aby dziedziczyć właściwość, strona podrzędna nie ustawia elementu w parametrach tej właściwości PageProperties . Przez nie„zastępowanie” wartość zdefiniowaną przez wydawcę nadrzędnego, strona akceptuje wartość dziedziczoną.
Na diagramie poniżej widać slajd dziedziczący właściwości z układu, dziedziczy z elementu nadrzędnego:
Właściwości użyte do renderowania slajdu to połączenie właściwości zdefiniowanych i odziedziczonych. W tym przykładzie wynikowe wartości użyte do renderowania slajdu 1 są następujące:
- WłaściwośćA ma wartość „Czerwony”.
- WłaściwośćB to „Orange”.
Dziedziczenie właściwości kształtu
Kształty mogą dziedziczyć właściwości takie jak wypełnienie, kontur lub cień, z innych elementów
kształtów. Kształt jest obiektem zastępczym, jeśli
Shape.placeholder
wartość pola. Pole Shape.placeholder.parentObjectId obiektu podrzędnego
wskazuje obiekt zastępczy nadrzędny. Gdy tworzysz nowy slajd na podstawie
wszystkie obiekty zastępcze w tym układzie pojawią się na nowym slajdzie jako kształty podrzędne.
Symbole zastępcze na stronach głównych mogą też pełnić rolę elementów nadrzędnych
.
Po zdefiniowaniu tej hierarchii dziedziczenia strona podrzędna dziedziczy właściwość przez nie można ustawić tej wartości w ShapeProperties . Niezastępując wartości zdefiniowanej przez element nadrzędny, kształt potomny akceptuje odziedziczoną wartość.
Na diagramie poniżej widać dziedziczenie właściwości między 3 elementami zmienne znajdujące się na slajdzie, układzie i wzorcu:
Właściwości służące do renderowania kształtu zastępczego są kombinacją tych właściwości między definicjami a elementami przez nią dziedziczonymi. W tym przykładzie obliczone wartości tych parametrów są następujące:
- Obiekt zastępczy1: właściwośćA jest renderowana jako „żółty”, a właściwośćB jako „zielona”.
- Obiekt zastępczy2: właściwośćA jest renderowana jako „Żółta”, a właściwośćB – „Fioletowy”.
- Obiekt zastępczy3: właściwośćA jest renderowana jako „Żółta”, a właściwośćB – „Fioletowy”.
Kształty to jedyny typ elementu strony, który może zawierać elementy nadrzędne. Inne typy takich jak obrazy, tabele i wykresy, nie mogą być obiektami zastępczymi ani mieć rodziców.
„Ukrywam” właściwości korzystające z właściwości PropertyState
Parametr PropertyState
decyduje o tym, czy właściwość kształtu jest rzeczywiście używana do renderowania,
lub jeśli wartość jest używana tylko do dziedziczenia według kształtów podrzędnych. Usługa z
stan właściwości NOT_RENDERED nie będzie używany do renderowania kształtu na
, jednak elementy podrzędne, których stan właściwości to RENDERED.
wciąż może odziedziczyć tę właściwość.
Na diagramie poniżej widać dziedziczenie właściwości między 3 elementami zmienne obsługujące pole PropertyState:
Na renderowanie właściwości kształtu wpływa pole PropertyState. W tym przykładzie otrzymane wartości tych kształtów są następujące:
- Obiekt zastępczy1: właściwośćA jest renderowana jako „Red”.
- Obiekt zastępczy2: właściwość A nie została renderowana. Jeśli była to właściwość Outline, Obiekt Placeholder2 nie będzie miał konspektu.
- Obiekt zastępczy3: właściwość A nie została wyrenderowana.
Jest jeszcze jedna możliwa wartość
Parametr PropertyState
wyliczenie: stan właściwości INHERIT oznacza, że stan właściwości
jest dziedziczona i należy użyć wartości elementu nadrzędnego. Kształty bez wartości
elementy nadrzędne nie mogą mieć stanu właściwości INHERIT.