Direct Share-Ziele angeben

Abbildung 1: Zeile „Direkt teilen“ im Sharesheet, siehe 1

Mit Direct Share-Zielen können Sie dies für Nutzer anderer Apps einfacher und schneller machen. um URLs, Bilder oder andere Daten mit Ihrer App zu teilen. Direct Share funktioniert indem Sie Kontakte aus Messaging- und sozialen Apps direkt auf dem Android-Gerät Sharesheet, ohne dass Nutzer die App auswählen und dann nach dem Kontakt suchen müssen.

ShortcutManagerCompat ist eine AndroidX API, die Verknüpfungen zum Teilen bereitstellt und abwärtskompatibel mit der eingestellten ChooserTargetService API ist. Dies ist die bevorzugte um sowohl die Freigabeverknüpfungen als auch ChooserTargets zu veröffentlichen. Eine Anleitung dazu finden Sie Siehe AndroidX verwenden, um sowohl Freigabeverknüpfungen als auch ChooserTargets bereitzustellen. auf dieser Seite.

Direct Share-Ziele veröffentlichen

In der Zeile „Direkte Freigabe“ des Freigabebereichs werden nur dynamische Verknüpfungen angezeigt, die von der Sharing Shortcuts API bereitgestellt werden. Führe die folgenden Schritte aus, um Direct Share zu veröffentlichen. Ziele.

  1. Deklariere in der XML-Ressourcendatei deiner App share-target-Elemente.

    <shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
<share-target android:targetClass="com.example.android.sharingshortcuts.SendMessageActivity">
    <data android:mimeType="text/plain" />
    <category android:name="com.example.android.sharingshortcuts.category.TEXT_SHARE_TARGET" />
</share-target>
</shortcuts>

  2. Verwende beim Initialisieren deiner App setDynamicShortcuts. um dynamische Verknüpfungen nach Wichtigkeit zu sortieren.

    Ein niedrigerer Index weist auf eine höhere Bedeutung hin. Wenn Sie eine Kommunikation können Top-Unterhaltungen nach Aktualität sortiert werden, für Ihre App. Veröffentlichen Sie keine veralteten Verknüpfungen. eine Unterhaltung ohne Nutzeraktivitäten der letzten 30 Tage gelten als veraltet.

    Kotlin

    ShortcutManagerCompat.setDynamicShortcuts(myContext, listOf(shortcut1, shortcut2, ..))

    Java

    List<ShortcutInfoCompat> shortcuts = new ArrayList<>();
shortcuts.add(shortcut1);
shortcuts.add(shortcut2);
...
ShortcutManagerCompat.setDynamicShortcuts(myContext, shortcuts);

  3. Wenn Sie eine Kommunikations-App entwickeln, melden Sie die Nutzung von Verknüpfungen über pushDynamicShortcut jedes Mal, wenn der Nutzer Nachrichten empfangen oder an einen Kontakt senden. Weitere Informationen finden Sie unter Nutzung von Kurzbefehlen melden für Kommunikations-Apps auf dieser Seite finden Sie weitere Informationen. Sie können beispielsweise die Nutzung von Nachrichten erfassen, die vom Nutzer gesendet wurden, indem Sie im Shortcut über ShortcutInfoCompat.Builder#addCapabilityBinding mit der Funktion actions.intent.SEND_MESSAGE Bindungen für die Fähigkeiten angeben.

    Kotlin

    val shortcutInfo = ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(firstName)
  .setLongLabel(fullName)
  .setCategories(matchedCategories)
  .setLongLived(true)
.addCapabilityBinding("actions.intent.SEND_MESSAGE").build()
ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo)

    Java

    ShortcutInfoCompat shortcutInfo = new ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(firstName)
  .setLongLabel(fullName)
  .setCategories(matchedCategories)
  .setLongLived(true)
  .addCapabilityBinding("actions.intent.SEND_MESSAGE")
  .build();

ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo);

  4. Wenn der Nutzer einen Kontakt löscht, verwenden Sie removeLongLivedShortcut Dies ist die empfohlene Methode, um die Verknüpfung zu entfernen, unabhängig davon, ob sie von Systemdiensten im Cache gespeichert ist. Das folgende Code-Snippet zeigt ein Beispiel dafür.

    Kotlin

    val deleteShortcutId = "..."
ShortcutManagerCompat.removeLongLivedShortcuts(myContext, listOf(deleteShortcutId))

    Java

    String deleteShortcutId = "...";
ShortcutManagerCompat.removeLongLivedShortcuts(
    myContext, Arrays.asList(deleteShortcutId));

Ranking der Direct Share-Ziele verbessern

Das Android-Teilen-Menü zeigt eine feste Anzahl von Direktfreigabezielen an. Diese Vorschläge sind nach Rang sortiert. Sie können das Ranking Ihrer Tastenkombinationen aufrufen:

  • Achten Sie darauf, dass alle shortcutIds eindeutig sind und niemals für unterschiedliche Ziele wiederverwendet werden.
  • Stellen Sie sicher, dass die Verknüpfung langlebig ist, indem Sie Folgendes aufrufen: setLongLived(true)
  • Nutzung von Tastenkombinationen in Bezug auf Unterhaltungen melden für ausgehende und eingehende Nachrichten, indem Sie die entsprechenden Verknüpfungen neu veröffentlichen bis ShortcutManagerCompat.pushDynamicShortcut. Weitere Informationen finden Sie auf dieser Seite unter Nutzung von Tastenkürzeln für Kommunikations-Apps melden.
  • Geben Sie keine irrelevanten oder veralteten Ziele für die direkte Freigabe an, z. B. Kontakte, mit denen der Nutzer in den letzten 30 Tagen nicht gechattet hat.
  • Geben Sie bei SMS-Apps keine Kurzcodes für Kurzcodes oder Unterhaltungen an als potenzieller Spam identifiziert werden. Es ist sehr unwahrscheinlich, dass Nutzer etwas teilen diese Gespräche.
  • Rufen Sie setCategories() auf, um die Verknüpfung mit dem passend mimeType Attribute enthalten. Beispiel: für eine SMS-App: Wenn der Kontakt nicht RCS oder MMS unterstützt, wird die Verknüpfen Sie die entsprechende Verknüpfung mit Nicht-Text-MIME-Typen wie image/* und video/*.
  • Sobald eine dynamische Verknüpfung für eine bestimmte Unterhaltung gesendet wurde und die Nutzung geändert wird, ändern Sie die ID der Verknüpfung nicht. Dadurch wird die Aufbewahrung von Nutzungsdaten sichergestellt für das Ranking.

Wenn der Nutzer auf ein Direct Share-Ziel tippt, muss er von Ihrer App zu einer Benutzeroberfläche weitergeleitet werden, kann er eine Aktion direkt gegenüber dem Ziel ausführen. Nicht präsentieren Nutzenden eine Begriffsbegründung angezeigt und platzieren Sie sie nicht in einer Benutzeroberfläche, die nichts mit dem Ziel angetippt. Wenn Sie z. B. in einer Messaging-App auf eine Direktfreigabe tippen, -Ziel leitet den Nutzer zu einer Konversationsansicht mit der ausgewählten Person weiter. Die Bildschirmtastatur sichtbar und die Nachricht ist mit den geteilten Daten vorausgefüllt.

Sharing Shortcuts API

Ab Android 10 (API-Ebene 29) wurden ShortcutInfo.Builder Methoden und Verbesserungen hinzugefügt, die zusätzliche Informationen zum Freigabeziel liefern:

setCategories()
Ab Android 10 werden Kategorien auch verwendet, um Tastenkombinationen zu filtern, die Share-Intents oder -Aktionen verarbeiten kann. Weitere Informationen finden Sie unter Freigaben deklarieren target. Dieses Feld ist für Tastenkombinationen erforderlich die als gemeinsame Ziele gedacht sind.
setLongLived()

Gibt an, ob eine Tastenkombination gültig ist, wenn ihre Veröffentlichung aufgehoben wurde, oder durch die App unsichtbar gemacht werden (als dynamische oder angepinnte Verknüpfung). Wenn eine Verknüpfung langlebig ist, können sie von verschiedenen Systemdiensten im Cache gespeichert werden, selbst nachdem sie die Veröffentlichung als dynamische Verknüpfung aufgehoben.

Wenn Sie eine Verknüpfung langlebiger machen, kann sich das Ranking verbessern. Weitere Informationen finden Sie unter Das Beste erhalten finden Sie weitere Informationen.

setShortLabel(), setLongLabel()

Wenn Sie einen Verknüpfungs-Shortcut zu einer einzelnen Person veröffentlichen, geben Sie in setLongLabel() den vollständigen Namen und in setShortLabel() einen Kurznamen wie einen Alias oder einen Vornamen an.

Ein Beispiel für die Veröffentlichung von Freigabeverknüpfungen auf GitHub

Bilder für Kurzbefehle bereitstellen

Wenn du eine Verknüpfung zum Teilen erstellen möchtest, musst du über setIcon() ein Bild hinzufügen.

Verknüpfungen zum Teilen können auf allen Systemoberflächen angezeigt und neu gestaltet werden. Außerdem können einige Geräte mit Android-Versionen 7, 8 oder 9 (API-Level 25, 26, 27 und 28) zeigen möglicherweise reine Bitmap-Symbole ohne Hintergrund an, was den Kontrast erheblich verringert. Damit die Verknüpfung wie gewünscht aussieht, stellen Sie mit IconCompat.createWithAdaptiveBitmap() eine adaptive Bitmap bereit.

Achten Sie darauf, dass adaptive Bitmaps denselben Richtlinien und Abmessungen für adaptive Symbole entsprechen. Die am häufigsten verwendete Methode besteht darin, die beabsichtigte quadratische Bitmap 72 x 72 dp und mittig auf einer transparenten Canvas mit 108 x 108 dp. Wenn Ihr Symbol transparente Bereiche enthält, müssen Sie eine Hintergrundfarbe hinzufügen. Andernfalls Transparente Bereiche erscheinen schwarz.

Verwenden Sie keine Bilder, die auf eine bestimmte Form maskiert sind. Bevor Sie beispielsweise Unter Android 10 (API-Level 29) wurden häufig Avatare für Direct Share bereitgestellt. ChooserTargets, die zu einem Kreis maskiert wurden. Das Android Sharesheet und andere Auf den Systemoberflächen in Android 10 werden jetzt Kurzbefehle für Formen und Designs angezeigt. Die bevorzugte Methode zum Bereitstellen von Verknüpfungen zum Teilen über ShortcutManagerCompat, Direct Share ChooserTarget-Objekte von Backcompat werden automatisch in für Sie zu erstellen.

Freigabeziel deklarieren

Freigabeziele müssen in der Ressourcendatei der App deklariert werden, ähnlich wie bei den Definitionen statischer Tastenkombinationen. Freigabe hinzufügen Zieldefinitionen im <shortcuts>-Stammelement der Ressourcendatei sowie andere statische Kurzbefehle. Jedes <share-targets>-Element enthält Informationen zum freigegebenen Datentyp, zu übereinstimmenden Kategorien und Zielklasse, die den Freigabe-Intent verarbeitet. Der XML-Code sieht in etwa so aus:

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
  <share-target android:targetClass="com.example.android.sharingshortcuts.SendMessageActivity">
    <data android:mimeType="text/plain" />
    <category android:name="com.example.android.sharingshortcuts.category.TEXT_SHARE_TARGET" />
  </share-target>
</shortcuts>

Das Datenelement in einem Ziel für die gemeinsame Nutzung ähnelt der Datenspezifikation in einem Intent-Filter. Jedes Freigabeziel kann Mehrere Kategorien, die nur für die veröffentlichten Kurzbefehle einer App verwendet werden mit seinen Share-Target-Definitionen. Kategorien können beliebige App-Definitionen haben Werte.

Für den Fall, dass der Nutzer im Android-Sharesheet die Verknüpfungsverknüpfung auswählt, die mit dem obigen Beispiel für den Zielanteil übereinstimmt, erhält die App Folgendes: Share Intent:

Action: Intent.ACTION_SEND
ComponentName: {com.example.android.sharingshortcuts /
                com.example.android.sharingshortcuts.SendMessageActivity}
Data: Uri to the shared content
EXTRA_SHORTCUT_ID: <ID of the selected shortcut>

Wenn der Nutzer das Freigabeziel über die Verknüpfungen im Launcher öffnet, erhält die App Intent erstellt, der beim Hinzufügen der Verknüpfungsverknüpfung zum ShortcutManagerCompat auf. Da es sich um einen anderen Intent handelt, ist Intent.EXTRA_SHORTCUT_ID nicht verfügbar. und Sie müssen die ID bei Bedarf manuell übergeben.

Nutzung von Kurzbefehlen für Kommunikations-Apps melden

Wenn Sie eine Kommunikations-App entwickeln, können Sie Ihr Ranking in der Android Sharesheet, indem die Nutzung sowohl für ausgehende als auch für eingehende Nachrichten gemeldet wird. Veröffentlichen Sie dazu die Verknüpfungsverknüpfung für die Unterhaltung, die den Kontakt repräsentiert, erneut über ShortcutManagerCompat.pushDynamicShortcut

Die Verwendung von Verknüpfungen und die Bindung von Funktionen sind abwärtskompatibel mit Android 5.0 (API 21).

Verwendung von Tastenkürzeln für ausgehende Nachrichten melden

Die Verwendung der Berichterstellung für vom Nutzer gesendete Nachrichten ähnelt funktionell der auf „Senden“ klicken, nachdem Sie eine Nachricht erstellt haben.

Wenn Sie Nutzungsberichte auslösen möchten, geben Sie in der Verknüpfung über ShortcutInfoCompat.Builder#addCapabilityBinding die Bindung mit der actions.intent.SEND_MESSAGE-Funktion an.

Kotlin

val shortcutInfo = ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(firstName)
  .setLongLabel(fullName)
  .setCategories(matchedCategories)
  .setLongLived(true)
.addCapabilityBinding("actions.intent.SEND_MESSAGE").build()
ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo)

Java

ShortcutInfoCompat shortcutInfo = new ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(firstName)
  .setLongLabel(fullName)
  .setCategories(matchedCategories)
  .setLongLived(true)
  .addCapabilityBinding("actions.intent.SEND_MESSAGE")
  .build();

ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo);

Wenn sich die ausgehende Nachricht auf einen Gruppenchat bezieht, musst du auch die Audience hinzufügen recipient-Parameter -Typ mit der Capability verknüpft ist.

Kotlin

val shortcutInfo = ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(groupShortTitle)
  .setLongLabel(groupLongTitle)
  .setCategories(matchedCategories)
  .setLongLived(true)
  .addCapabilityBinding("actions.intent.SEND_MESSAGE", "message.recipient.@type", listOf("Audience")).build()

ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo)

Java

ShortcutInfoCompat shortcutInfo = new ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(groupShortTitle)
  .setLongLabel(groupLongTitle)
  .setCategories(matchedCategories)
  .setLongLived(true)
  .addCapabilityBinding("actions.intent.SEND_MESSAGE", "message.recipient.@type", Arrays.asList("Audience"))
  .build();

ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo);

Nutzung von Kurzbefehlen für eingehende Nachrichten melden

Wenn Sie Nutzungsberichte auslösen möchten, wenn der Nutzer eine Nachricht wie eine SMS, eine Chatnachricht, eine E-Mail oder Benachrichtigungen erhält, müssen Sie zusätzlich über ShortcutInfoCompat.Builder#addCapabilityBinding mit der Funktion actions.intent.RECEIVE_MESSAGE Verknüpfungen für die Funktionen im Shortcut angeben.

Kotlin

val shortcutInfo = ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(firstName)
  .setLongLabel(fullName)
  .setCategories(matchedCategories)
  .setLongLived(true)
  .addCapabilityBinding("actions.intent.RECEIVE_MESSAGE").build()

ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo)

Java

ShortcutInfoCompat shortcutInfo = new ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(firstName)
  .setLongLabel(fullName)
  .setCategories(matchedCategories)
  .setLongLived(true)
  .addCapabilityBinding("actions.intent.RECEIVE_MESSAGE")
  .build();

ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo);

Wenn die eingehende Nachricht aus einem Gruppenchat stammt, musst du auch die Audience hinzufügen Parameterwert als sender-Typ festlegen mit der Capability verbunden ist.

Kotlin

val shortcutInfo = ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(groupShortTitle)
  .setLongLabel(groupLongTitle)
  .setCategories(matchedCategories)
  .setLongLived(true)
  .addCapabilityBinding("actions.intent.RECEIVE_MESSAGE", "message.sender.@type", listOf("Audience")).build()

ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo)

Java

ShortcutInfoCompat shortcutInfo = new ShortcutInfoCompat.Builder(myContext, staticConversationIdentifier)
  ...
  .setShortLabel(groupShortTitle)
  .setLongLabel(groupLongTitle)
  .setCategories(matchedCategories)
  .setLongLived(true)
  .addCapabilityBinding("actions.intent.RECEIVE_MESSAGE", "message.sender.@type", Arrays.asList("Audience"))
  .build();

ShortcutManagerCompat.pushDynamicShortcut(myContext, shortcutInfo);

Mit AndroidX sowohl Freigabe-Verknüpfungen als auch ChooserTargets bereitstellen

Damit Sie mit der AndroidX-Kompatibilitätsbibliothek arbeiten können, muss das Manifest der App muss den Metadaten-Auswahldienst und Intent-Filter enthalten. Weitere Informationen finden Sie unter die aktuelle ChooserTargetService Direct Share API.

Dieser Dienst ist bereits in der Kompatibilitätsbibliothek deklariert, also tut der Nutzer Der Dienst muss nicht im Manifest der App deklariert werden. Der Link von Die Freigabeaktivität für den Dienst muss als Auswahlziel berücksichtigt werden. Dienstanbieter.

Im folgenden Beispiel ist die Implementierung von ChooserTargetService androidx.core.content.pm.ChooserTargetServiceCompat, die bereits definiert ist in AndroidX:

<activity
    android:name=".SendMessageActivity"
    android:label="@string/app_name"
    android:theme="@style/SharingShortcutsDialogTheme">
    <!-- This activity can respond to Intents of type SEND -->
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/plain" />
    </intent-filter>
    <!-- Only needed if you import the sharetarget AndroidX library that
         provides backwards compatibility with the old DirectShare API.
         The activity that receives the Sharing Shortcut intent needs to be
         taken into account with this chooser target provider. -->
    <meta-data
        android:name="android.service.chooser.chooser_target_service"
        android:value="androidx.sharetarget.ChooserTargetServiceCompat" />
</activity>

Häufig gestellte Fragen zum Teilen von Verknüpfungen

Wie werden die Nutzungsdaten der Verknüpfung gespeichert und verlassen sie das Gerät?

Verknüpfungen werden vollständig auf dem Gerät im Systemdatenverzeichnis in einem die verschlüsselte Laufwerkpartition. Informationen in Kürzeln wie Symbol, Intent, und Namen von Personen und Ressourcen sind nur für Systemdienste und die die Verknüpfungen veröffentlicht.

Wie ist Direct Share entstanden?

Wir haben die Funktion „Direct Share“ in Android 6.0 (API-Level 23) eingeführt, damit Apps ChooserTarget-Objekte über ChooserTargetService bereitstellen. Die Ergebnisse waren reaktiv bei Bedarf abgerufen, was zu einer langsamen Ladezeit für Ziele führt.

In Android 10 (API-Level 29) haben wir die ChooserTargetService Direct ersetzt Teile APIs mit der neuen Sharing Shortcuts API. Anstatt Ergebnisse abzurufen, Mit der Sharing Shortcuts API können Apps reaktiv on demand Direct Share veröffentlichen. im Voraus festzulegen. Dadurch wurde das Abrufen von Direct Share schnell beschleunigt für die Erstellung von ShareSheet. Die ChooserTargetService Direct Share funktioniert zwar weiterhin, aber das System sortiert die bereitgestellten Ziele als jedes Ziel, das die Sharing Shortcuts API verwendet.

Android 11 (API-Level 30) hat den ChooserTargetService-Dienst eingestellt und Die Sharing Shortcuts API ist die einzige Möglichkeit, Direct Share-Ziele anzugeben.

Wie unterscheiden sich veröffentlichte Verknüpfungen für Freigabeziele von Launcher-Verknüpfungen (die typische Verwendung von Verknüpfungen, wenn Sie lange auf App-Symbole im Launcher drücken)?

Alle für ein „Ziel teilen“ veröffentlichte Verknüpfungen ist auch ein Launcher, Verknüpfung und wird im Menü angezeigt, wenn du lange auf das App-Symbol drückst. Die Die maximale Anzahl an Kurzbefehlen pro Aktivität gilt auch für die Gesamtzahl der Verknüpfungen, die eine App veröffentlicht (Ziele teilen und alte Launcher-Verknüpfungen kombiniert).

Wie viele Tastenkombinationen zum Teilen sollte veröffentlicht werden?

Die Anzahl der Freigabe-Verknüpfungen ist auf die gleiche Anzahl von dynamischen Verknüpfungen beschränkt, die über getMaxShortcutCountPerActivity(android.content.Context) verfügbar sind. Jeder kann beliebige können Sie diese Beschränkung nicht überschreiten. Beachten Sie jedoch, dass die Verknüpfungen im App Launcher lange drücken und im Tabellenblatt zum Teilen. Die meisten App-Launcher zeigen beim langen Drücken maximal vier oder fünf Verknüpfungen im Hochformat und acht im Querformat an. Ansehen Häufig gestellte Fragen .

Zurück
Einfache Daten von anderen Apps empfangen