Satu film, satu kesepakatan. Nobar tanpa debat grup chat.

Activity, UI/UX & Widget Dasar Versi dasar

Activity adalah satu layar aplikasi dengan siklus hidup sendiri (onCreate, onStart, onResume, …) dan layout XML. Widget dasar seperti TextView, Button, dan EditText dipakai untuk menampilkan data serta menerima aksi pengguna.

Activity

LoginActivity, HomeActivity, MovieDetailActivity, MovieRoomActivity, CreateRoomActivity. Alur terkait dapat memakai Fragment.

TextView

Judul, sinopsis, genre, rating, dan status room.

Button

Login, buat room, gabung room, minta rekomendasi, simpan favorit.

EditText

Data akun, kode room, dan permintaan rekomendasi AI (TextInputLayout untuk pesan error).

ImageView / ProgressBar

Poster film dan indikator saat memuat daftar atau menunggu respons AI.

LoginActivity.java

public class LoginActivity extends AppCompatActivity {
    private TextInputLayout tilEmail;
    private TextInputEditText etEmail;
    private Button btnLogin;
    private ProgressBar progress;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_login);

        tilEmail = findViewById(R.id.tilEmail);
        etEmail  = findViewById(R.id.etEmail);
        btnLogin = findViewById(R.id.btnLogin);
        progress = findViewById(R.id.progress);

        btnLogin.setOnClickListener(v -> attemptLogin());
    }

    private void attemptLogin() {
        String email = String.valueOf(etEmail.getText()).trim();
        if (email.isEmpty()) {
            tilEmail.setError("Email wajib diisi");
            return;
        }
        tilEmail.setError(null);
        progress.setVisibility(View.VISIBLE);
        // ... proses autentikasi
    }
}

Navigasi Antar Halaman Versi dasar

Intent eksplisit memindahkan pengguna dari satu Activity ke Activity lain dan membawa data kecil lewat extras. Penerima wajib memeriksa data itu sebelum memakainya.

Detail film

Klik item daftar membuka MovieDetailActivity dengan extra ID film.

Room

Buat atau gabung room membuka MovieRoomActivity dengan extra kode room.

Validasi

Jika extra hilang, tampilkan pesan dan tutup layar, bukan crash.

Fragment

Opsional untuk alur terkait di dalam satu Activity.

Constants.java + pengirim + penerima

public final class Constants {
    public static final String EXTRA_MOVIE_ID  = "extra_movie_id";
    public static final String EXTRA_ROOM_CODE = "extra_room_code";
}

// Pengirim: daftar film -> detail
Intent intent = new Intent(this, MovieDetailActivity.class);
intent.putExtra(Constants.EXTRA_MOVIE_ID, movie.getId());
startActivity(intent);

// Penerima: validasi sebelum dipakai
long movieId = getIntent().getLongExtra(Constants.EXTRA_MOVIE_ID, -1L);
if (movieId == -1L) {
    Toast.makeText(this, "Data film tidak tersedia", Toast.LENGTH_SHORT).show();
    finish();
    return;
}

// Gabung room: kirim kode undangan
Intent room = new Intent(this, MovieRoomActivity.class);
room.putExtra(Constants.EXTRA_ROOM_CODE, code);
startActivity(room);

Penyimpanan Data: SharedPreferences & SQLite Versi dasar + pengembangan

SharedPreferences menyimpan pasangan kunci–nilai ringan. SQLite menyimpan data terstruktur yang bisa di-query. Keduanya lokal di perangkat dan tidak menggantikan penyimpanan online untuk sinkronisasi antarperangkat.

SharedPreferences

Preferensi ringan (genre terakhir, pengaturan tampilan). Bukan untuk password atau kunci API.

SQLite

Favorit, cache daftar film, dan riwayat nobar.

Online

Voting room antarperangkat memerlukan penyimpanan online karena database lokal tidak cukup untuk sinkronisasi real-time.

SharedPreferences + DbHelper (SQLite)

// SharedPreferences: preferensi ringan (bukan password / kunci API)
SharedPreferences prefs = getSharedPreferences("mt_prefs", MODE_PRIVATE);
prefs.edit().putString("last_genre", "Komedi").apply();
String genre = prefs.getString("last_genre", "Semua");

// SQLite: tabel favorit
public class DbHelper extends SQLiteOpenHelper {
    public DbHelper(Context c) { super(c, "movietracker.db", null, 1); }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL("CREATE TABLE favorites (" +
                "movie_id INTEGER PRIMARY KEY, " +
                "title TEXT NOT NULL, " +
                "poster_url TEXT, " +
                "added_at INTEGER NOT NULL)");
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldV, int newV) {
        // migrasi bertahap, jangan hapus data pengguna
    }

    public void addFavorite(long id, String title, String poster) {
        ContentValues v = new ContentValues();
        v.put("movie_id", id);
        v.put("title", title);
        v.put("poster_url", poster);
        v.put("added_at", System.currentTimeMillis());
        getWritableDatabase().insertWithOnConflict(
                "favorites", null, v, SQLiteDatabase.CONFLICT_REPLACE);
    }
}

RecyclerView & List Data Pengembangan

RecyclerView menampilkan daftar panjang secara efisien dengan mendaur ulang tampilan. Adapter menghubungkan data ke tampilan, dan ViewHolder menyimpan referensi widget tiap baris.

Jelajah film

Daftar film per genre.

Favorit

Daftar film yang disimpan di SQLite.

Kandidat rekomendasi

Hasil AI Rekomendasi dan film kandidat voting.

Klik item

Membuka detail dengan mengirim ID film lewat Intent.

MovieAdapter.java + pemasangan di Activity

public class MovieAdapter extends RecyclerView.Adapter<MovieAdapter.VH> {
    public interface OnMovieClick { void onClick(Movie movie); }

    private final List<Movie> items = new ArrayList<>();
    private final OnMovieClick listener;

    public MovieAdapter(OnMovieClick listener) { this.listener = listener; }

    public void submit(List<Movie> data) {
        items.clear();
        items.addAll(data);
        notifyDataSetChanged();
    }

    @NonNull @Override
    public VH onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View v = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_movie, parent, false);
        return new VH(v);
    }

    @Override
    public void onBindViewHolder(@NonNull VH h, int position) {
        Movie m = items.get(position);
        h.title.setText(m.getTitle());
        h.meta.setText(m.getGenre() + " · " + m.getDuration() + " mnt");
        h.itemView.setOnClickListener(v -> listener.onClick(m));
    }

    @Override public int getItemCount() { return items.size(); }

    static class VH extends RecyclerView.ViewHolder {
        final TextView title, meta;
        VH(View v) {
            super(v);
            title = v.findViewById(R.id.tvTitle);
            meta  = v.findViewById(R.id.tvMeta);
        }
    }
}

// di Activity
RecyclerView rv = findViewById(R.id.rvMovies);
rv.setLayoutManager(new LinearLayoutManager(this));
MovieAdapter adapter = new MovieAdapter(movie -> openDetail(movie.getId()));
rv.setAdapter(adapter);

Integrasi API Publik Pengembangan

Aplikasi mengambil data JSON dari REST API lewat HTTP di thread latar, lalu menampilkannya di UI. Untuk data yang harus sinkron antarperangkat, Firebase (Firestore/Realtime Database) cocok sebagai penyimpanan online.

API data film

Penyedia belum ditetapkan. Dipilih setelah memeriksa dokumentasi, batas penggunaan, keamanan, dan lisensi.

AI Rekomendasi

Permintaan diteruskan lewat layanan perantara agar kunci API tidak tertanam di APK.

Room voting

Firebase untuk sinkronisasi suara antarperangkat (contoh di bawah).

Status

Loading, data kosong, jaringan gagal, dan batas permintaan harus punya pesan jelas.

Retrofit: ambil daftar film

public interface MovieApi {
    @GET("movies")
    Call<MovieResponse> byGenre(@Query("genre") String genre);
}

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl(BuildConfig.API_BASE_URL)   // alamat layanan perantara
        .addConverterFactory(GsonConverterFactory.create())
        .build();
MovieApi api = retrofit.create(MovieApi.class);

api.byGenre("komedi").enqueue(new Callback<MovieResponse>() {
    @Override
    public void onResponse(Call<MovieResponse> c, Response<MovieResponse> r) {
        if (r.isSuccessful() && r.body() != null) adapter.submit(r.body().results);
        else showState("Data kosong atau batas permintaan tercapai");
    }
    @Override
    public void onFailure(Call<MovieResponse> c, Throwable t) {
        showState("Jaringan gagal. Coba lagi.");
    }
});

Firebase Firestore: suara Nobar Match

FirebaseFirestore db = FirebaseFirestore.getInstance();

// kirim suara satu anggota untuk satu film
Map<String, Object> vote = new HashMap<>();
vote.put("uid", uid);
vote.put("movieId", movieId);
vote.put("like", true);
db.collection("rooms").document(roomCode)
  .collection("votes").document(uid + "_" + movieId)
  .set(vote);

// pantau suara seluruh anggota secara real-time
db.collection("rooms").document(roomCode).collection("votes")
  .addSnapshotListener((snap, e) -> {
      if (e != null || snap == null) { showState("Gagal memuat hasil"); return; }
      tallyAndShow(snap.getDocuments());
  });

Monetisasi Aplikasi dengan AdMob Opsional

AdMob menayangkan iklan (banner, interstitial, rewarded) dan membayar pengembang per tayangan atau klik. Selama pengembangan wajib memakai ID iklan uji milik Google.

Paket Gratis

Banner di bawah daftar film. Interstitial dibatasi frekuensinya.

Paket Plus

Iklan disembunyikan (tanpa iklan).

Aturan

Jangan klik iklan sendiri dan jangan taruh iklan di tempat yang mudah tersentuh tak sengaja. Tidak ada iklan di layar Login.

Gradle, Manifest, layout, dan Java (ID uji resmi Google)

// build.gradle (module app)
implementation("com.google.android.gms:play-services-ads:<versi terbaru>")

<!-- AndroidManifest.xml (ID aplikasi uji resmi Google) -->
<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-3940256099942544~3347511713" />

<!-- activity_movie_list.xml (unit banner uji) -->
<com.google.android.gms.ads.AdView
    android:id="@+id/adView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    ads:adSize="BANNER"
    ads:adUnitId="ca-app-pub-3940256099942544/6300978111" />

// MovieListActivity.java
MobileAds.initialize(this, status -> { });
AdView adView = findViewById(R.id.adView);
if (UserPrefs.isPlus(this)) {
    adView.setVisibility(View.GONE);          // paket Plus: tanpa iklan
} else {
    adView.loadAd(new AdRequest.Builder().build());
}