Unduh UnityNativeShare - Unduh Kode Sumber UnityNativeShare

UnityNativeShare

Kode sumber lainnya

v1.5.3

Unduh

Plugin berbagi asli Unity

Perhatikan: Aset ini tidak lagi dipertahankan! Pertimbangkan untuk menggunakan solusi berbagi alternatif yang secara aktif dipertahankan. Saat menggunakan paket ini, harapkan masalah saat berbagi file/gambar/video dengan teks (lihat FAQ).

Tersedia di toko aset: https://assetstore.unity.com/packages/tools/integration/native-hare-for-android-ios-112731

Thread Forum: https://forum.unity.com/threads/native-hare-for-android-ios-open-source.519865/

Perselisihan: https://discord.gg/ujjt549aav

Mendukung pengembang ☕

Plugin ini membantu Anda berbagi file secara asli (gambar, video, dokumen, dll.) Dan/atau teks biasa di Android & iOS. ContentProvider digunakan untuk berbagi media di Android.

INSTALASI

Ada 5 cara untuk menginstal plugin ini:

Impor NativeHare.unityPackage melalui paket aset-impor
Klon/Unduh repositori ini dan pindahkan folder plugin ke folder aset proyek Unity Anda
impor dari toko aset
(via Paket Manager) Tambahkan baris berikut ke paket/manifest.json :
- "com.yasirkula.nativeshare": "https://github.com/yasirkula/UnityNativeShare.git",
(via OpenUpm) Setelah menginstal OpenUpm-CLI, jalankan perintah berikut:
- openupm add com.yasirkula.nativeshare

Pengaturan Android

NativeHare tidak lagi membutuhkan pengaturan manual di Android. Jika Anda menggunakan versi plugin yang lebih lama, Anda perlu menghapus <provider ... /> NativeShare dari androidmanifest.xml Anda.

Untuk referensi, dokumentasi warisan tersedia di: https://github.com/yasirkula/unitynativeshare/wiki/manual-setup-for-android

Pengaturan iOS

Ada dua cara untuk mengatur plugin di iOS:

A. Pengaturan Otomatis: (Opsional) Ubah Nilai Deskripsi Penggunaan Perpustakaan Foto di Pengaturan Proyek/Yasirkula/Saham Asli
B. Pengaturan Manual: Lihat: https://github.com/yasirkula/unitynativeshare/wiki/manual-setup-for-ios

Bagaimana

Cukup buat objek NativeShare baru dan sesuaikan dengan merantai fungsi -fungsi berikut sesuai keinginan Anda (lihat kode contoh):

Clear() : Menghapus Konten Bagikan yang Ditentukan sebelumnya (jika ada). Hanya berguna jika instance NativeShare yang sama akan digunakan kembali untuk efisiensi memori
SetSubject( string subject ) : Mengatur subjek (terutama digunakan dalam aplikasi email)
SetText( string text ) : Mengatur teks yang dibagikan. Perhatikan bahwa aplikasi Facebook akan menghilangkan teks, jika ada (lihat topik ini)
SetUrl( string url ) : Mengatur URL bersama. Pada aplikasi iOS yang didukung, URL ini digunakan untuk menghasilkan pratinjau halaman web target. Aplikasi iOS lainnya dapat menambahkan URL ke teks atau menghilangkannya. Saat berbagi file di iOS atau saat berbagi apa pun di Android, URL ditambahkan ke teks (kecuali teks sudah berisi URL)
AddFile( string filePath, string mime = null ) : Menambahkan file di path ke tindakan berbagi. Anda dapat menambahkan beberapa file dari berbagai jenis. Mime file secara otomatis ditentukan jika dibiarkan nol; Namun, jika file tidak memiliki ekstensi dan/atau Anda sudah tahu mime file, Anda dapat memasukkan pantomim secara manual. Pantomim tidak berpengaruh pada iOS
AddFile( Texture2D texture, string createdFileName = "Image.png" ) : Menghemat tekstur ke aplikasi.
AddEmailRecipient( string emailAddress ) : Auto-Populates bidang penerima aplikasi email pada platform Android. Tidak berpengaruh pada iOS
SetTitle( string title ) : Menetapkan judul dialog Bagikan di Platform Android. Tidak berpengaruh pada iOS
AddTarget( string androidPackageName, string androidClassName = null ) : Berbagi konten pada aplikasi spesifik pada platform Android. Jika AndroidClassName dibiarkan nol, daftar kegiatan dalam dialog Share akan dipersempit ke kegiatan di AndroidPackAgename yang ditentukan yang dapat menangani tindakan berbagi ini. Perhatikan bahwa AndroidClassName, jika disediakan, harus menjadi nama lengkap dari aktivitas (dengan paketnya). Anda dapat menyebut fungsi ini beberapa kali. Fungsi ini tidak berpengaruh pada iOS
SetCallback( ShareResultCallback callback ) : Mengikuti fungsi callback setelah tindakan berbagi selesai. ShareresultCallback memiliki tanda tangan berikut: void ShareResultCallback( ShareResult result, string shareTarget )
- ShareResult result dapat mengambil 3 nilai:
  - Tidak Diketahui: Kami tidak dapat menentukan apakah pengguna telah membagikan konten atau tidak
  - Dibagikan: Pengguna mungkin telah membagikan konten. Nilai ini menjamin bahwa pengguna setidaknya memilih aplikasi dari lembar berbagi. Tetapi tidak mungkin untuk mengatakan apakah pengguna benar -benar membagikan konten atau membatalkan operasi setelah memilih aplikasi dari lembar berbagi
  - Notshared: Entah pengguna telah segera menutup lembar berbagi atau memilih aplikasi dari lembar berbagi tetapi kemudian memutuskan untuk tidak membagikan konten (sayangnya, sebagian besar aplikasi mengembalikan dibagikan untuk kasus terakhir)
- string shareTarget menyimpan informasi tentang aplikasi yang telah dipilih pengguna dari lembar berbagi. Itu bisa nol atau kosong, jika informasi ini tidak disediakan. Biasanya, ini adalah nama paket/nama kelas dari aplikasi yang dipilih. Anda dapat menggunakan nilai ini untuk misalnya menentukan apakah pengguna telah memilih Twitter dari lembar berbagi: shareTarget != null && shareTarget.ToLowerInvariant().Contains( "twitter" )

Akhirnya, memanggil fungsi Share () dari objek NativeHare akan menyajikan lembar berbagi.

Fungsi utilitas

bool NativeShare.TargetExists( string androidPackageName, string androidClassName = null ) : Mengembalikan apakah aplikasi dengan paket/nama kelas yang ditentukan ada di perangkat Android. Jika AndroidClassName dibiarkan nol, hanya nama paket yang ditanya. Fungsi ini selalu mengembalikan true di iOS
bool FindTarget( out string androidPackageName, out string androidClassName, string packageNameRegex, string classNameRegex = null ) : Temukan nama paket/kelas dari aplikasi yang diinstal pada perangkat Android menggunakan ekspresi reguler. Mengembalikan true jika nama paket/kelas yang cocok ditemukan dengan sukses. Dapat bermanfaat saat Anda ingin menggunakan fungsi AddTarget tetapi tidak tahu nama paket/kelas yang tepat dari aktivitas target. Jika Classnameregex dibiarkan nol, aktivitas pertama dalam paket pencocokan dikembalikan. Fungsi ini selalu mengembalikan false di iOS

FAQ

Bisakah saya berbagi pada aplikasi tertentu?

Di Android, Anda dapat berbagi pada aplikasi tertentu melalui AddTarget . Untuk iOS, Anda dapat melihat posting ini dan melihat apakah itu berhasil untuk Anda: https://forum.unity.com/threads/native-hare-for-android-ios-open-source.519865/page-4#post -4011874

Saya tidak dapat berbagi gambar dengan teks di aplikasi x

Tidak mungkin untuk berbagi gambar/file dengan teks/subjek pada beberapa aplikasi (misalnya Facebook), mereka sengaja menghilangkan gambar atau teks dari konten yang dibagikan. Aplikasi ini mengharuskan Anda menggunakan SDK mereka sendiri untuk tindakan berbagi yang kompleks. Untuk kompatibilitas terbaik, saya sarankan Anda untuk berbagi hanya gambar atau hanya teks.

Saya tidak dapat membangun proyek ke Android, dikatakan "Linking Sumber Daya Android Gagal: Elemen Tak Terduga <Queries> Ditemukan di <Imifest>" dalam pesan kesalahan

NativeHare menambahkan elemen <queries> ke androidmanifest.xml karena perubahan visibilitas paket yang baru. Kesalahan build dapat diperbaiki dengan mengikuti langkah-langkah ini: Android 11, Android 12. Dalam kasus terburuk, jika Anda baik-baik saja dengan NativeHare tidak bekerja pada beberapa perangkat yang terkena dampak, maka Anda dapat membuka NativeShare.aar dengan Winrar atau 7-Zip dan kemudian hapus elemen <queries>...</queries> dari androidmanifest.xml .

Saat menggunakan Unity sebagai perpustakaan di Android, aplikasi macet saat berbagi file

Jika Anda menjalankan aktivitas persatuan dalam proses yang terpisah, maka modifikasi androidmanifest.xml di dalam nativeShare.aar sehingga baik NativeShareCustomShareDialogActivity dan NativeShareBroadcastListener juga berjalan pada proses yang sama, misalnya:

< activity android : name = " .NativeShareCustomShareDialogActivity " ... android : process = " :YourProcess " />
< receiver android : name = " .NativeShareBroadcastListener " ... android : process = " :YourProcess " />

Tidak dapat berbagi, katanya "java.lang.classnotfoundException: com.yasirkula.unity.nativeShare" di logcat

Jika Anda yakin bahwa plugin Anda terkini, maka aktifkan opsi file proguard khusus dari pengaturan pemain dan tambahkan baris berikut ke file tersebut: -keep class com.yasirkula.unity.* { *; }

Tidak dapat berbagi saat menggunakan Beebyte Obfuscator, dikatakan "Pengecualian: Tidak ada metode proxy seperti itu: xyz.hasManagedCallback ()" di logcat

Tambahkan NativeShareNamespace.NSShareResultCallbackAndroid ke bagian Skip Classes Aset Pengaturan Obfuscator Anda.

Kode contoh

Kode berikut menangkap tangkapan layar permainan setiap kali Anda mengetuk layar, menyimpannya di jalur sementara dan kemudian membagikannya:

 void Update ( )
{
	if ( Input . GetMouseButtonDown ( 0 ) )
		StartCoroutine ( TakeScreenshotAndShare ( ) ) ;
}

private IEnumerator TakeScreenshotAndShare ( )
{
	yield return new WaitForEndOfFrame ( ) ;

	Texture2D ss = new Texture2D ( Screen . width , Screen . height , TextureFormat . RGB24 , false ) ;
	ss . ReadPixels ( new Rect ( 0 , 0 , Screen . width , Screen . height ) , 0 , 0 ) ;
	ss . Apply ( ) ;

	string filePath = Path . Combine ( Application . temporaryCachePath , " shared img.png " ) ;
	File . WriteAllBytes ( filePath , ss . EncodeToPNG ( ) ) ;

	// To avoid memory leaks
	Destroy ( ss ) ;

	new NativeShare ( ) . AddFile ( filePath )
		. SetSubject ( " Subject goes here " ) . SetText ( " Hello world! " ) . SetUrl ( " https://github.com/yasirkula/UnityNativeShare " )
		. SetCallback ( ( result , shareTarget ) => Debug . Log ( " Share result: " + result + " , selected app: " + shareTarget ) )
		. Share ( ) ;

	// Share on WhatsApp only, if installed (Android only)
	//if( NativeShare.TargetExists( "com.whatsapp" ) )
	//	new NativeShare().AddFile( filePath ).AddTarget( "com.whatsapp" ).Share();
}