Android-Werbefilm (Launch Video)
Eine Methode und ein Toolkit zur Erstellung des Google-Play-Werbevideos (16:9), des vertikalen Schnitts für soziale Medien (9:16) – jeweils mit und ohne Voice-Over – sowie der Store-Bilder, basierend auf der echten App im Emulator. Der Anspruch ist ein fertiger Agenturfilm, nicht nur eine Bildschirmaufnahme.
Dieses Skill adaptiert product-launch-motion (von AbubakrChan, MIT) für Android. Dieses Skill ist eine Voraussetzung und wird nicht mitgeliefert: Installieren Sie es von https://github.com/AbubakrChan/product-launch-motion (getestet bei Commit edbfb105) und lesen Sie vor dem Schreiben von Film-Code:
SKILL.mdreferences/technique.mdreferences/prompts.mdlegacy/references/03-word-locked-sync.mdlegacy/references/07-sound-and-master.md
Was für Android anders ist: Touch-Indikatoren statt eines Cursors, echte 60-fps-Aufnahme statt nachgebauter Bewegung, undurchsichtige Oberflächen für alles, was vom Bildschirm abgehoben ist, Musik geprüft auf Vocal-Chop-Artefakte, per Spracherkennung verifizierte Erzählung und die Play-Store-Richtlinien.
Die Werkzeuge befinden sich in tools/ (Index in references/tools.md). Ausführliche Details sind in references/; diese Datei enthält die Methode und die Regeln.
1. Liefergegenstände
| Stück | Spezifikation |
|---|---|
| Play- / YouTube-Video | 1920x1080, 60 fps, H.264, AAC 48 kHz, -14 LUFS integriert, True Peak <= -1 dBTP |
| Vertikales Social-Media-Video | 1080x1920, gleiche Spezifikationen, eigenständig komponiert (niemals ein Ausschnitt des 16:9) |
| Jeweils mit und ohne Voice-Over | Vier Master. Der geschnittene Sprechertext wird separat erstellt und ersetzt niemals den reinen Musik-Schnitt |
| Play-Screenshots | Bis zu 8, 1080x1920, 24-Bit PNG ohne Alpha (oder JPEG) |
| Feature-Grafik | 1024x500 ohne Alpha; die Mitte (ca. x 362 bis 662) freilassen: Play platziert dort den Play-Button |
| Social-Stills | 1080x1920 |
| Vorschauen | Maximal 14 MB pro Stück, zur Anzeige in einem Artifact |
Länge: etwa 40 s, niemals mehr als 50 s.
Im 9:16-Format darf sich nichts Wichtiges (Text, Logo, Button) in den Bereichen befinden, die Reels, Shorts und TikTok mit ihrer UI überdecken: die oberen 14 %, die unteren 20 % und etwa 120 px vom rechten Rand.
2. Produktionsregeln (zustimmen, dann einhalten)
- Fertiges Produkt. Beurteilen Sie jedes Bild wie einen bezahlten Agenturfilm.
- Echte Bewegung. Alles, was sich im Telefon bewegt, ist die mit 60 fps aufgezeichnete App. Keine Bewegung wird aus animierten Screenshots nachgebaut. Ein Clip, der ruckelt, wird neu aufgenommen.
- Kein Cursor. Android hat keine Maus. Jede Berührung wird mit einer weichen Scheibe und der Material-Welle markiert, am Ort und im Moment der echten Berührung (aus dem Berührungsprotokoll der Aufnahme).
- Keine andere App auf dem Bildschirm (Messaging-Apps, Karten, Browser, Account-Auswahl). Wenn die App auf einem Button eine andere App nennt, darf das Wort vorgelesen werden; die andere App erscheint niemals.
- Nichts schwebt ohne Oberfläche. Alles, was vom Telefonbildschirm abgehoben ist, sitzt auf einer eigenen undurchsichtigen Oberfläche: der Karte selbst oder dem Container der App für diesen Abschnitt, mit seinem Radius, seiner Farbe und einem weichen Schatten. Kein Text liegt über dem Telefon, und kein Text überlappt einen anderen.
- Identisch mit der App. Ein abgehobenes Element beginnt als exakter Ausschnitt des sichtbaren Bildes und überblendet in der Luft mit einer kurzen Unschärfe zu einer Vektorreplik, die gegen diesen Ausschnitt kalibriert ist. Keine erfundenen Abzeichen, Symbole, Buttons oder Daten.
- Nichts, was nicht zur Marke oder zur App gehört. Kein Play-Symbol auf dem finalen Button, keine Vollbild-Farbüberblendungen, keine Box hinter einem Text, um ihn lesbar zu machen: Größen stattdessen anpassen.
- Die Marke eröffnet und schließt, zentriert auf ihrer Achse in beiden Formaten.
- Lebendige Bewegung. Lange Striche, die sich dehnen, ausdünnen und im Takt kreuzen, wirken besser als steife Blöcke.
- Glaubwürdige Daten: echte Marktwerte für die Domäne der App, niemals echte persönliche Daten.
- Text in der Sprache des Listings mit korrekten Diakritika, keine Gedankenstriche.
- Der Prüfer genehmigt das Skript, die Musik, die Stimme und die Markenaussprache vor der Produktion und sieht nichts, was nicht zuerst geprüft wurde (Abschnitt 11).
3. Rollen und Genehmigungen
- Regisseur (die Hauptsitzung): spricht mit dem Prüfer, startet Unteragenten, prüft und veröffentlicht. Fragen an den Prüfer gehen über AskUserQuestion.
- Analyse-Subagent: Produkt, Marke, Abläufe, lokale Umgebung, Beispieldaten, Aufnahmeplan und Skript. Er baut die App nicht und startet den Emulator nicht.
- Genehmigungen: Storyboard in einem Artifact (Schlüsselbilder mit Playwright gezeichnet und vor dem Zeigen betrachtet), Skript nach Takten, Musik, Sprach-Casting, Markenaussprache und Erlaubnis, den Monitor während der Aufnahme zu drehen.
- Produktions-Subagent: Build, Emulatoren, Aufnahme, Film, Audio, Erzählung, Rendern, Standbilder, Prüfungen und Liefergegenstände. Er protokolliert den Fortschritt in
PROGRESS.mdim Arbeitsverzeichnis. - Abschluss: Der Regisseur prüft und veröffentlicht; Notizen des Prüfers gehen zurück an die Produktion (SendMessage), bis genehmigt.
4. Lokale Umgebung und Daten
- Nur lokale Emulatoren. Überprüfen Sie vor dem Befüllen, dass jede Emulator-Host-Variable gesetzt ist: Ein Befüllen über ein Admin-SDK mit einer fehlenden Variable schreibt in die Produktion.
- Glaubwürdige Daten für den Zielmarkt: Namen, Orte, Preise und Fotos. Fotos mit einer Lizenz, die kommerzielle Nutzung erlaubt, Quelle notiert, keine Drittanbieter-Marken.
- Standort:
adb -s <serial> emu geo fix <längengrad> <breitengrad>. - Release- oder Profil-Build, ohne Debug-Overlays und auf die Emulatoren ausgerichtet. Ein Patch, der nur für die Aufnahme existiert (Umgebungsbanner ausblenden, Wartezeit überspringen), bleibt uncommittet und wird am Ende zurückgesetzt.
- Telemetrie (Absturzberichte, Analyse) in diesem Build ausschalten oder nachweisen, dass sie nicht in die Produktion gelangt.
- Saubere Statusleiste mit dem SystemUI-Demo-Modus (
tools/capture/demo.sh): 9:41, voller Akku und WLAN, keine Benachrichtigungen. - Systemanimationsskalierung auf 1 während der Aufnahme; bei 0 bewegt sich die App nicht wie ein Telefon.
- Geteilte Backends: Wenn etwas Geteiltes (eine Staging-Datenbank) Schreibvorgänge erhält, zählen Sie die Zeilen vorher und nachher. Eine lokale API mit simulierten Anbietern kann erfundene Daten in einer gemeinsamen Datenbank hinterlassen.
5. Echte 60-fps-Aufnahme
screenrecord im Emulator reicht nicht: etwa 41 fps bei 1080x2400 (53 bei 720x1600), und Scrollen wirkt ruckelig. Nur für Tests verwenden (tools/capture/clip.py). Optionen:
- Windows-Host + GPU (getestet). Emulator unter Windows mit
-gpu host, der Monitor auf Hochformat gedreht, damit das Telefon 1:1 passt, ffmpegsddagrab(Desktop Duplication) mit 60 fps auf den Telefonbildschirm beschnitten und gedreht, nahezu verlustfrei mithevc_amf(AMD; getestet) oderh264_nvenc/hevc_nvenc(NVIDIA; ungetestet) codiert.tools/capture/capture.py(ClipGPU) zeichnet auf, protokolliert jede Berührung und Wischbewegung mit der Emulator-Uhr und verschiebt den Clip nach WSL. - Physisches Telefon mit scrcpy (UNGETESTET).
scrcpy --recordmit der Bildwiederholrate des Telefons; das Berührungsprotokoll und die Synchronisation müssten angepasst werden. - macOS / Linux-Hosts: nicht abgedeckt.
Dann sync60.py: gleicht jede Berührung mit der von ihr verursachten visuellen Änderung ab, measure2.py, stutter.py und jumps.py messen das Ergebnis (der getestete Aufbau ergab 53 bis 59 eindeutige Bilder pro Sekunde), und app_fps.sh zeigt, ob die App selbst mit 60 fps im Emulator zeichnet. Schritt für Schritt mit den Windows-Prüfungen (entsperrte Sitzung, Bildschirm-Timeout, freier Speicher): references/capture-60fps.md.
6. Der Film
Schreiben Sie DIRECTION.md (Markenfarben und Schriftarten aus dem App-Theme, Logo, Konzept, Skript nach Takten, Regeln), dann PLAN.md, und erst dann Programmcode. Eine HTML-Seite (film/index.html?f=16x9 oder ?f=9x16), in der alles eine reine Funktion von seek(t) ist: geschlossene Federn, keine CSS-Übergänge, keine Timer. tools/video/film/core.js ist die Engine (Federn, Spuren, rollende Ziffern). Innerhalb eines generischen Vektor-Telefonrahmens (keine Herstellermarkierung) spielt nur die echte Aufnahme, Bild für Bild aus seek(t), mit den Touch-Indikatoren, die aus dem Berührungsprotokoll gezeichnet werden.
Rendern mit Playwright: 4 Unterbilder pro Bild, gemittelt mit ffmpeg tmix bei 60 fps, in parallelen Segmenten, die auf den freien Speicher abgestimmt sind. Entwürfe mit 30 fps und halber Größe. Kontaktabzüge pro Takt und Einzelbilder zur Überprüfung. Rollende Ziffern werden Bild für Bild geprüft: Sie dürfen niemals Müll dazwischen zeigen. Details: references/film.md.
7. Musik
- Mixkit-Tracks unter der Mixkit-Lizenz (https://mixkit.co/license/); Titel und Autor werden in den Credits genannt. Der Regisseur wählt aus, der Prüfer hört vor dem Schnitt zu.
tools/music/enthält einen Katalog (Titel, Autor, Genre, Länge, Link) und eine Tempo-/Energieanalyse; kein Audio ist beigefügt. - Eigenes Beat-Gitter (
video/scripts/grid.py): gemessenes Tempo und Phase des ersten Takts. Schnitte liegen auf dem Beat mit Equal-Power-Überblendungen von etwa 14 ms im Einbruch vor dem Angriff. - Vocal-Chop-Prüfung. Manche Tracks enthalten Chop-Vocals, die für das Ohr wie Wörter klingen (manchmal unhöfliche).
fingerprint.pyundmusic_check.pyvergleichen den spektralen Fingerabdruck des Hits (40 Log-Bänder von 250 Hz bis 6 kHz, Kosinus-Ähnlichkeit) mit jedem Beat des Schnitts: Keiner darf 0,88 erreichen. Diese Takte bleiben außen vor und ihre Echos werden abgesenkt. - Soundeffekte synthetisiert, auf die Tonart des Tracks gestimmt und auf den gemessenen Peak platziert (
audio.py). - Mix Startpunkt: Track x 0,5 + Effekte x 0,62, -14 LUFS, True Peak <= -1 dBTP.
Details:
references/audio.md.
8. Erzählung (Voice-Over)
- Gemini TTS, Modell
gemini-3.8-flash-tts. Der Schlüssel kommt nur aus der UmgebungsvariableGEMINI_API_KEY: niemals ausgedruckt, niemals in einer Befehlszeile, niemals in einem Repository oder Chat.tts.pysendet ihn nur in einem Header und entfernt ihn aus Fehlern. - Wenige kostenlose Generierungen pro Tag. Jede Anfrage wird protokolliert; ein 429 wird gemeldet und nicht wiederholt. Budgetieren Sie sie: eine kurze Casting-Zeile pro Stimme, dann das gesamte Skript in einer Anfrage pro Take.
- Casting: eine natürliche, warme Stimme, nicht roboterhaft. Gute Kandidaten: Sulafat (warm), Laomedeia (lebhaft), Leda (jugendlich).
- Markenaussprache: Fragen Sie den Prüfer vor der Generierung; sie kommt in die Regieanweisungen des Prompts („ausgesprochen ... wie ...“), niemals auf dem Bildschirm. faster-whisper large-v3 (
transcribe.py) prüft sie mit und ohne Hinweis. Das Modell ist nicht beigefügt: https://huggingface.co/Systran/faster-whisper-large-v3 - Stimme zuerst. Jede Zeile hat ihr Fenster im Film und ihr Schlüsselwort fällt auf die von ihr benannte visuelle Änderung (
segment.py,place.py,timing_table.py,pace.py). - Mix mit Erzählung (
narrated_mix.py): Die Musik duckt sich unter jeder Zeile um 9 bis 12 dB unter die Stimme, mit Rampen.check_margin.pyfindet, wo die Stimme verliert,audio_artifacts.pyfindet Klicks und Schnitte. Details:references/narration.md.
9. Store-Bilder und Play-Metadaten
- Screenshots: Saubere Bilder des 9:16-Films (
store_shots.mjs, ein einzelnesseek(t)pro Bild, keine Bewegungsunschärfe) oder echte Bildschirme mit einer Überschrift. 1080x1920, 24-Bit PNG ohne Alpha (png_srgb.py). Das erste gibt das Wertversprechen an. - Feature-Grafik 1024x500: Marke, eine Zeile und das Telefon, Mitte freigehalten.
- Social-Stills 1080x1920, unter Beachtung der sicheren Zonen aus Abschnitt 1.
- Play-Metadaten-Regeln, die auch für das Video gelten: kein „#1“, „Beste“, Auszeichnungen, Erfahrungsberichte, Aufrufe zum Herunterladen, datierte Angebote oder wiederholte Schlüsselwörter, und nichts, was die App nicht tut.
Details:
references/store-assets.md.
10. Lieferung
- Haupt-Artifact: die vier Vorschauen, die Standbilder, die Listing-Texte und die Musik-Credits.
- Eine Download-Seite pro Format (Artifact
downloads-Fähigkeit). Master werden in 14-MB-Teile geteilt (tools/delivery/split.sh), im Browser zusammengebaut und mit SHA-256 verifiziert, bevor sie zum Speichern angeboten werden (tools/delivery/downloads/index.html, getestet mittools/editor/test-downloads.mjs). Eine Veröffentlichung sendet bis zu 64 MB: Laden Sie die Teile in mehreren Stapeln auf dieselbe URL hoch. - Optional die Master in einen Windows-Ordner kopieren (
masters_dir_wslin der Konfiguration). - Hochladen zu Play oder Social nur auf Wunsch des Prüfers.
11. Bevor Sie etwas zeigen
Sehen Sie sich jeden Kontaktabzug selbst an, in Originalgröße und im Kontext, und führen Sie die Prüfungen von references/checks.md durch: Film (overlaps.mjs, purity.mjs, errors.mjs), Rendern (jumps.py, stutter.py), Audio (-14 LUFS, True Peak, kein vocal-förmiger Hit, volle Stimme gemäß Whisper) und die visuelle Liste (kein Cursor, keine andere App, keine Debug-Banner, saubere Statusleiste, keine persönlichen Daten, kein abgeschnittener Text, keine Rechtschreibfehler).
12. Maschinenpflege
Vor jedem rechenintensiven Durchlauf uptime, free -g und den freien Windows-Speicher prüfen. Renderläufe erfolgen innerhalb eines speicherbegrenzten Bereichs, ein Gradle-Build nach dem anderen, Temperaturen bei langen Läufen überwachen (Pause bei CPU über 85 °C oder GPU über 80 °C), Windows niemals unter 2 GB freiem Speicher. Niemals Prozesse oder Emulatoren anderer Sitzungen beenden. Details: references/checks.md, Abschnitt „Maschinenpflege“.
13. Aufräumen
Den Android-Emulator und alle anderen gestarteten Emulatoren herunterfahren, den Monitor und die Bildschirm-Timeout-Einstellung wiederherstellen, nur für die Aufnahme erforderliche Patches und temporäre Konfigurationen zurücksetzen, den Windows-Aufnahmeordner leeren und klar angeben, was noch aussteht.
Referenzen
references/capture-60fps.md: Windows-Host-Aufnahme, Schritt für Schritt.references/film.md: Filmseitenvertrag, Engine, Rendern, Überprüfungsbögen.references/audio.md: Musikauswahl, Beat-Gitter, Vocal-Chop-Prüfung, Effekte, Mix.references/narration.md: Gemini TTS, Casting, Whisper-Prüfungen, Platzierung, Mix mit Erzählung.references/store-assets.md: Screenshots, Feature-Grafik, Play-Regeln.references/checks.md: Prüfliste vor der Ansicht und Maschinenpflege.references/lessons.md: Hart erarbeitete Lektionen, als Regeln.references/tools.md: Jedes Werkzeug, was es tut und wie man es aufruft.